codebase-memory-mcp
MCP-сервер, который строит граф кода: функции, классы, вызовы и маршруты, и отвечает на структурные запросы агента локально
- 48 531 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает всю кодовую базу и записывает настройки в конфигурацию агентов
- Запускает фоновый демон, наблюдатель за файлами и локальный веб-интерфейс
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bashmacOS и Linux. Установщик скачивает бинарник и настраивает найденные агенты. Затем перезапустите агента.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает всю кодовую базу и записывает настройки в конфигурацию агентов
- Запускает фоновый демон, наблюдатель за файлами и локальный веб-интерфейс
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер индексирует репозиторий и строит граф связей кода: функции, классы, цепочки вызовов, HTTP-маршруты и связи между сервисами. Разбор идет через грамматики tree-sitter для большого числа языков, часть языков дополнена разрешением типов. Агент задает структурные запросы, например кто вызывает функцию, где мертвый код или как изменения затрагивают другие части, вместо чтения файлов по одному. Все работает локально, без ключей API и внешнего сервиса, код не покидает машину. Есть встроенная 3D-визуализация графа в браузере и общий для команды снимок графа, который можно закоммитить в репозиторий.
Для кого. Разработчикам, которые хотят, чтобы агент ориентировался в крупной кодовой базе по структуре, а не перечитывал файлы.
Подходит, если
- Нужно быстро понять архитектуру и связи в большом репозитории
- Нужно узнать, кто вызывает функцию, и оценить влияние изменений
- Нужен поиск по коду и графу без чтения множества файлов в контекст
- Хочется локальный инструмент без ключей API и внешних сервисов
Не подходит, если
- Нужен готовый ответ словами без агента: сервер только строит и отдает граф
- Проект крошечный, и обычного поиска по файлам достаточно
- Нельзя запускать локальный бинарник и фоновый процесс
Пример запроса к агенту
Проиндексируй проект и покажи, кто вызывает функцию ProcessOrderMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
CBM_CACHE_DIR- Каталог кеша и индексов, по умолчанию ~/.cache/codebase-memory-mcp.
CBM_DIAGNOSTICS- Включает запись диагностического журнала для отчетов о памяти и производительности.
Ограничения
Сервер это только бэкенд анализа, он не содержит модель и полагается на агента как на интеллектуальный слой. Он читает вашу кодовую базу и записывает настройки в конфигурацию агента: для этого он и создан. На Windows Microsoft Defender может помечать бинарник как ложное срабатывание, автор объясняет это в документации. Общий снимок графа, если коммитить его на каждое изменение, сильно раздувает историю git, поэтому лучше делать это по расписанию.
Как отключить. Выполните codebase-memory-mcp uninstall: команда убирает записи в конфигурации агентов, хуки и сам бинарник, а индексы удаляет после подтверждения.
Частые вопросы
Нужен ли ключ API или интернет?
Нет. Индексация и запросы работают локально, ключи API не нужны, код не покидает машину.
Сервер сам отвечает на вопросы словами?
Нет. Он строит и отдает граф, а формулирует ответ ваш агент, который вызывает инструменты сервера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который индексирует код через tree-sitter и отдает агенту отдельные функции и классы вместо целых файлов
MCP-сервер строит граф знаний о коде: поиск по смыслу, граф вызовов, трассировка HTTP-маршрутов и анализ влияния правок.
MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
MCP-сервер CodeAlive: агент ищет по смыслу и точно в больших кодовых базах и разбирает связи вызовов, не читая репозиторий целиком
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| codebase-memory-mcp (эта карточка) | нет | не нужна | 48 531 | |
| Ix | нет | 1 155 | ix превращает репозиторий в постоянный граф символов | |
| Token Savior | нет | не нужна | 1 217 | token Savior индексирует код по символам |
| CodeGraph на Rust | нет | не нужна | 915 | граф кода для агента на Rust |
Коротко о README
README описывает codebase-memory-mcp как локальный движок анализа кода для агентов, оформленный как MCP-сервер и нативный бинарник без языковой среды. Он разбирает код через tree-sitter для большого числа языков и строит устойчивый граф знаний с функциями, классами, вызовами, маршрутами и связями между сервисами. Доступно около 15 инструментов MCP: поиск, трассировка вызовов, обзор архитектуры, оценка влияния изменений, запросы в стиле Cypher, поиск мертвого кода и другое. Установка идет скриптом, через npm, PyPI, Homebrew и другие менеджеры, есть встроенная 3D-визуализация графа и общий для команды снимок. Все работает локально, без ключей API и телеметрии.