Codebase Memory MCP: граф кода для Claude Code, Codex и Cursor

DeusData/codebase-memory-mcp· Проверено 12.11.2026· 48,6 тыс.на GitHub

Строит по репозиторию локальный граф: функции, вызовы, маршруты, документацию, Docker, Kubernetes и CI. Агент находит нужный код запросом к графу, без чтения файлов подряд, ключи и облако не нужны.

Одна программа на C без зависимостей: 17 инструментов, 163 языка, индекс в SQLite на вашем диске; лицензия MIT.

Как подключить

Что сделать до подключения

1

Программа ставится скриптом install.sh (macOS, Linux) или install.ps1 (Windows) из репозитория либо архивом со страницы релизов

2

Скрипт сам прописывает сервер в найденных клиентах; флаг --skip-config ставит только программу, и тогда в command указывается полный путь к ней

3

Для Claude Code есть плагин: claude plugin marketplace add DeusData/codebase-memory-mcp, затем claude plugin install codebase-memory@codebase-memory

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio codebase-memory \
  -- /path/to/codebase-memory-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

index_repositoryиндексирует репозиторий в граф
list_projectsпоказывает проиндексированные проекты
delete_projectудаляет проект из графа
index_statusпроверяет состояние индекса
check_index_coverageпроверяет, свежий ли индекс по путям
search_graphищет символы по графу
trace_pathпрослеживает вызовы и потоки данных
detect_changesоценивает, что задевает дифф
query_graphвыполняет запрос Cypher
get_graph_schemaописывает узлы и связи
compare_graphsсравнивает два снимка индекса
get_code_snippetчитает код функции
get_file_outlineпоказывает оглавление файла
get_architectureдаёт обзор устройства проекта
search_codeищет текст в файлах проекта
manage_adrведёт архитектурные решения
ingest_tracesдобавляет наблюдённые пути вызовов

Что попросить агента

«Проиндексируй этот проект»Агент вызовет index_repository с полным путём к папке, затем index_status
«Что вызывает <ProcessOrder>?»Агент вызовет trace_path с направлением inbound и перескажет цепочку вызовов
«Какие функции и тесты заденут мои незакоммиченные изменения?»Агент вызовет detect_changes, для тестов — со scope: tests, и перечислит затронутые символы
«Расскажи, как устроен этот репозиторий»Агент вызовет get_architecture, при нужде уточнит детали через get_file_outline и get_code_snippet
«Что запускает и куда разворачивает задача <deploy> в CI?»Агент вызовет trace_path в режиме deploy от задачи CI

Для каких задач

Найти в незнакомом проекте, где реализована функция и кто её вызывает
Оценить, какие символы и тесты заденет текущий дифф
Проследить, что запускает и разворачивает задача CI, скрипт или правило Make
Получить обзор проекта: языки, пакеты, маршруты, горячие точки
Найти раздел документации или архитектурное решение рядом с кодом, который оно описывает
Вести записи архитектурных решений (ADR) в индексе проекта

Ограничения

!

Автоиндексация выключена по умолчанию: проект индексируют вызовом index_repository или командой config set auto_index true; папки вне git после индексации не отслеживаются, пока не включить watch_non_git

!

Точность разбора зависит от языка: из 163 языков на тестовых репозиториях проверены 35, у OCaml и Haskell она ниже 75%

!

Smart CI экспериментальный и сужает прогон тестов только для кода C и C++

!

Microsoft Defender может пометить программу как Trojan:Script/Wacatac.B!ml; разработчики называют это ложным срабатыванием, файл сверяется по checksums.txt из релиза

Если не работает

В /mcp нет codebase-memory-mcp
Проверьте, что в .mcp.json указан абсолютный путь к программе, и перезапустите агента. Проверка: echo '{}' | /path/to/binary должна вывести JSON.
index_repository отваливается по таймауту клиента
Запустите индексацию с async: true и проверяйте ход вызовом с status: true.
trace_path возвращает 0 результатов
Сначала найдите точное имя через search_graph с шаблоном вида .*PartialName.*, затем повторите trace_path.
Запросы отдают результаты чужого проекта
Добавьте параметр project с именем проекта; имена показывает list_projects.
После установки система не находит программу
Добавьте ~/.local/bin в PATH: export PATH="$HOME/.local/bin:$PATH".

Частые вопросы

Где хранятся индексы и как их сбросить?
В базах SQLite в папке ~/.cache/codebase-memory-mcp, они переживают перезапуск. Другую папку задаёт переменная CBM_CACHE_DIR. Чтобы сбросить всё, удалите эту папку.
Как быстро индексируется проект?
На Apple M3 Pro полный индекс ядра Linux (28 млн строк, 75 тыс. файлов) строится за 3 минуты, Django — примерно за 6 секунд. Запрос Cypher по готовому графу занимает меньше 1 мс.
Нужна ли серверу своя языковая модель?
Нет. Сервер строит граф и отвечает на запросы, а вопросы в вызовы инструментов переводит ваш агент. Модель в браузере может включить только визуальная оболочка CBM Lens, и ответы она считает на устройстве.
Как поделиться индексом с командой?
Вызовите index_repository с persistence: true: рядом с кодом появится сжатый снимок .codebase-memory/graph.db.zst, и коллега при индексации клона начнёт с него. Снимок переписывается при каждой индексации, поэтому коммитьте его по расписанию, например к релизу.
Как обновить или удалить сервер?
Обновление — повторный запуск install.sh или install.ps1, команда codebase-memory-mcp update печатает нужную строку. Команда codebase-memory-mcp uninstall убирает программу и записи в клиентах, а индексы по умолчанию оставляет.
Как установить Codebase Memory MCP в Claude Code?
Запустите install.sh или install.ps1: скрипт найдёт Claude Code и пропишет сервер вместе с навыком и хуками. Второй путь — плагин: claude plugin marketplace add DeusData/codebase-memory-mcp и claude plugin install codebase-memory@codebase-memory. Ставьте что-то одно, иначе сервер запустится дважды.
С какими клиентами работает Codebase Memory MCP?
Установщик настраивает 46 клиентов, среди них Claude Code, Codex CLI, Cursor, VS Code, Gemini CLI, OpenCode и Qwen Code. Для ручной настройки конфиги этих клиентов собраны во вкладках блока «Как подключить».
Что такое CBM Lens?
Визуальная оболочка к графу в бете v0.0.1: карта архитектуры, 3D-граф Galaxy, просмотр исходников и локальный чат по коду. Входит в стандартный релиз и запускается командой codebase-memory-mcp daemon start --open --port=9749.
Работает ли сервер из России?
Индексация и запросы идут на вашем компьютере, программа сама не выходит в сеть и не собирает телеметрию; ключи и зарубежные аккаунты не нужны.

Похожие серверы