codegraph — MCP-сервер для Claude Code: граф кода и 42 инструмента
Строит семантический граф проекта и отдаёт его ИИ-агенту через 42 инструмента. Пригодится, когда агент вместо поиска по файлам должен видеть связи между функциями.
claude mcp add codegraph -- npx -y @astudioplus/codegraph-mcpЧто делает codegraph
CodeGraph разбирает репозиторий и собирает граф: функции, классы, импорты, цепочки вызовов. Разбор идёт через tree-sitter, поддерживается 38 языков. Агент получает структурированную картину кода вместо перебора файлов grep-ом.
Сервер поднимается как обычный MCP-сервер и индексирует текущий рабочий каталог. Есть флаги: --workspace для нескольких проектов, --exclude для пропуска каталогов, --max-files с лимитом 5000 файлов, --profile для урезания набора инструментов. Режим --graph-only строит только граф, без эмбеддингов — семантический поиск и память в нём недоступны.
Модель эмбеддингов задаётся флагом --embedding-model, по умолчанию bge-small. Векторы помечаются настройками, при которых их построили, поэтому процесс с другими флагами их игнорирует и пересчитывает в фоне. Если оставить запущенный --watch-демон со старыми флагами, сессии на нём будут работать без семантического поиска, пока демон не перезапустят.
Какие задачи решает
- найти всех вызывающих функцию перед правкой
- оценить, что затронет изменение в общем модуле
- дать агенту контекст по коду без чтения десятков файлов
- проверить PR на пропущенные тесты и устаревшие доки
- искать по коду на естественном языке в проекте на TypeScript
Примеры запросов агенту
- Покажи, кто вызывает
parseConfigв этом проекте - Что сломается, если я поменяю сигнатуру
handleRequest? - Найди в коде место, где собирается граф зависимостей
Как установить codegraph
Командой платформы
claude mcp add codegraph -- npx -y @astudioplus/codegraph-mcpКомандой платформы
codex mcp add codegraph -- npx -y @astudioplus/codegraph-mcpФайл настроек
{
"mcpServers": {
"codegraph": {
"command": "npx",
"args": [
"-y",
"@astudioplus/codegraph-mcp"
]
}
}
}Файл настроек
{
"servers": {
"codegraph": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@astudioplus/codegraph-mcp"
]
}
}
}Командой платформы
gemini mcp add codegraph npx -y @astudioplus/codegraph-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о codegraph
Как установить codegraph в Claude Code?
Одной командой: claude mcp add codegraph -- npx -y @astudioplus/codegraph-mcp. После этого сервер сам проиндексирует текущий каталог.
Что делает codegraph?
Строит граф кода — функции, классы, импорты, вызовы — и отдаёт его агенту через 42 инструмента. Агент видит структуру проекта, а не отдельные файлы.
Что нужно для семантического поиска?
Модель эмбеддингов, по умолчанию bge-small. В режиме --graph-only эмбеддинги не строятся, поэтому семантический поиск и инструменты памяти в нём не работают.
