codebase-memory-mcp
MCP-сервер, который строит граф кода: функции, классы, вызовы и маршруты, и отвечает на структурные запросы агента локально
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает всю кодовую базу и записывает настройки в конфигурацию агентов
- Запускает фоновый демон, наблюдатель за файлами и локальный веб-интерфейс
Установка
Ручная установка
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bashmacOS и Linux. Установщик скачивает бинарник и настраивает найденные агенты. Затем перезапустите агента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер индексирует репозиторий и строит граф связей кода: функции, классы, цепочки вызовов, HTTP-маршруты и связи между сервисами. Разбор идет через грамматики tree-sitter для большого числа языков, часть языков дополнена разрешением типов. Агент задает структурные запросы, например кто вызывает функцию, где мертвый код или как изменения затрагивают другие части, вместо чтения файлов по одному. Все работает локально, без ключей API и внешнего сервиса, код не покидает машину. Есть встроенная 3D-визуализация графа в браузере и общий для команды снимок графа, который можно закоммитить в репозиторий.
Для кого. Разработчикам, которые хотят, чтобы агент ориентировался в крупной кодовой базе по структуре, а не перечитывал файлы.
Подходит, если
- Нужно быстро понять архитектуру и связи в большом репозитории
- Нужно узнать, кто вызывает функцию, и оценить влияние изменений
- Нужен поиск по коду и графу без чтения множества файлов в контекст
- Хочется локальный инструмент без ключей API и внешних сервисов
Не подходит, если
- Нужен готовый ответ словами без агента: сервер только строит и отдает граф
- Проект крошечный, и обычного поиска по файлам достаточно
- Нельзя запускать локальный бинарник и фоновый процесс
Пример запроса к агенту
Проиндексируй проект и покажи, кто вызывает функцию ProcessOrderОграничения
Сервер это только бэкенд анализа, он не содержит модель и полагается на агента как на интеллектуальный слой. Он читает вашу кодовую базу и записывает настройки в конфигурацию агента: для этого он и создан. На Windows Microsoft Defender может помечать бинарник как ложное срабатывание, автор объясняет это в документации. Общий снимок графа, если коммитить его на каждое изменение, сильно раздувает историю git, поэтому лучше делать это по расписанию.
Как отключить. Выполните codebase-memory-mcp uninstall: команда убирает записи в конфигурации агентов, хуки и сам бинарник, а индексы удаляет после подтверждения.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| CBM_CACHE_DIR | Каталог кеша и индексов, по умолчанию ~/.cache/codebase-memory-mcp. |
| CBM_DIAGNOSTICS | Включает запись диагностического журнала для отчетов о памяти и производительности. |
Проверка безопасности
- Читает всю кодовую базу и записывает настройки в конфигурацию агентов
- Запускает фоновый демон, наблюдатель за файлами и локальный веб-интерфейс
Коротко о README
README описывает codebase-memory-mcp как локальный движок анализа кода для агентов, оформленный как MCP-сервер и нативный бинарник без языковой среды. Он разбирает код через tree-sitter для большого числа языков и строит устойчивый граф знаний с функциями, классами, вызовами, маршрутами и связями между сервисами. Доступно около 15 инструментов MCP: поиск, трассировка вызовов, обзор архитектуры, оценка влияния изменений, запросы в стиле Cypher, поиск мертвого кода и другое. Установка идет скриптом, через npm, PyPI, Homebrew и другие менеджеры, есть встроенная 3D-визуализация графа и общий для команды снимок. Все работает локально, без ключей API и телеметрии.
Частые вопросы
Нужен ли ключ API или интернет?
Нет. Индексация и запросы работают локально, ключи API не нужны, код не покидает машину.
Сервер сам отвечает на вопросы словами?
Нет. Он строит и отдает граф, а формулирует ответ ваш агент, который вызывает инструменты сервера.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything