
Codebase Memory MCP: граф кода для Claude Code, Codex и Cursor
Строит по репозиторию локальный граф: функции, вызовы, маршруты, документацию, Docker, Kubernetes и CI. Агент находит нужный код запросом к графу, без чтения файлов подряд, ключи и облако не нужны.
Одна программа на C без зависимостей: 17 инструментов, 163 языка, индекс в SQLite на вашем диске; лицензия MIT.
Как подключить
Что сделать до подключения
Программа ставится скриптом install.sh (macOS, Linux) или install.ps1 (Windows) из репозитория либо архивом со страницы релизов
Скрипт сам прописывает сервер в найденных клиентах; флаг --skip-config ставит только программу, и тогда в command указывается полный путь к ней
Для 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.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.codebase-memory]
command = "/path/to/codebase-memory-mcp"
args = []Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"codebase-memory": {
"command": "/path/to/codebase-memory-mcp",
"args": []
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"codebase-memory": {
"type": "stdio",
"command": "/path/to/codebase-memory-mcp",
"args": []
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"codebase-memory": {
"command": "/path/to/codebase-memory-mcp",
"args": []
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"codebase-memory": {
"command": "/path/to/codebase-memory-mcp",
"args": []
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"codebase-memory": {
"type": "local",
"command": ["/path/to/codebase-memory-mcp"]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"codebase-memory": {
"command": "/path/to/codebase-memory-mcp",
"args": []
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"codebase-memory": {
"command": "/path/to/codebase-memory-mcp",
"args": []
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
index_repositoryиндексирует репозиторий в графlist_projectsпоказывает проиндексированные проектыdelete_projectудаляет проект из графаindex_statusпроверяет состояние индексаcheck_index_coverageпроверяет, свежий ли индекс по путямsearch_graphищет символы по графуtrace_pathпрослеживает вызовы и потоки данныхdetect_changesоценивает, что задевает диффquery_graphвыполняет запрос Cypherget_graph_schemaописывает узлы и связиcompare_graphsсравнивает два снимка индексаget_code_snippetчитает код функцииget_file_outlineпоказывает оглавление файлаget_architectureдаёт обзор устройства проектаsearch_codeищет текст в файлах проектаmanage_adrведёт архитектурные решенияingest_tracesдобавляет наблюдённые пути вызововЧто попросить агента
Для каких задач
Ограничения
Автоиндексация выключена по умолчанию: проект индексируют вызовом 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 из релиза