CodeGraph MCP
Структурные вопросы о коде вместо перебора файлов: 38 языков, 42 инструмента, расширения для VS Code и JetBrains, режим для CI
- 155 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Движок скачивается как нативный исполняемый файл и работает с правами пользователя
- Индекс и эмбеддинги хранят фрагменты исходного кода на диске
Установка
- Работает в
Ручная установка
/path/to/codegraph-server --mcpЗапуск MCP-сервера, команда записывается в `~/.claude.json`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Движок скачивается как нативный исполняемый файл и работает с правами пользователя
- Индекс и эмбеддинги хранят фрагменты исходного кода на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CodeGraph строит семантический граф кода: функции, классы, импорты и цепочки вызовов. Разбор идет через tree-sitter для 38 языков, поверх графа лежат эмбеддинги для поиска по смыслу и постоянный слой памяти. Агент получает 42 инструмента MCP и вместо перебора файлов задает вопросы о структуре: кто вызывает функцию, что заденет правка, где дубли. Модели эмбеддингов на выбор: `bge-small` по умолчанию, `jina-code-v2`, `granite-97m` и очень быстрая статическая `static`. Движок собирается из исходников или скачивается готовым бинарником в `~/.codegraph/bin`, тот же движок обслуживает расширение для VS Code и плагин для JetBrains. Для CI есть режим `--graph-only`, а команда `codegraph-server --graph-only --run-tool codegraph_pr_context` готовит комментарий к запросу на слияние: радиус влияния, пробелы в тестах, устаревшие документы, подходящие рецензенты. Правила для агентов лежат в отдельном репозитории.
Для кого. Разработчикам больших кодовых баз на нескольких языках, которым агент нужен для навигации по связям, а не для перебора файлов.
Подходит, если
- Перед правкой функции нужно узнать, кто ее вызывает и какие тесты затронет изменение
- Монорепозиторий на пяти языках, и поиск по тексту дает слишком много шума
- В CI нужен автоматический комментарий к запросу на слияние с радиусом влияния правки
- Агент ищет дубли функций по смыслу, а не по точному совпадению текста
Не подходит, если
- Проект маленький: встроенного поиска агента хватает, а индекс будет лишним слоем
- Нужен облачный сервис без локального бинарника: движок запускается на вашей машине
- Нужен только текстовый поиск по логам или документам: граф строится по исходному коду
Пример запроса к агенту
Покажи, кто вызывает функцию parse_config, какие модули заденет ее изменение и какие тесты стоит перезапуститьMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Движок в расширение не вложен: при первой активации оно просит подтвердить загрузку бинарник для платформы, сверяет контрольную сумму и кладет его в `~/.codegraph/bin`, потому что это нативный исполняемый файл с правами пользователя. После перехода на версию 0.21 каждый проект один раз заново строит эмбеддинги в фоне, а работающий демон `--watch` нужно перезапустить. Старые индексы версии 0.20.1 и ниже не несут сведений о модели. Лицензия Apache 2.0, на 6 октября 2026 года последний коммит. Правила для агентов вынесены в репозиторий `codegraph-rules-for-agents`.
Как отключить. Удалите запись `codegraph` из `~/.claude.json`, расширение и плагин JetBrains, а бинарник и индексы уберите вручную из `~/.codegraph`.
Частые вопросы
Как подключить CodeGraph к Claude Code?
Пропишите в `~/.claude.json` сервер `codegraph` с командой `/path/to/codegraph-server` и аргументом `--mcp`. Текущий каталог индексируется сам.
Сколько инструментов и языков?
42 инструмента MCP и 38 языков через tree-sitter. Инструменты разведены по задачам: структура, вызовы, влияние, поиск по смыслу и память.
Что такое режим `--graph-only`?
Это режим без эмбеддингов и ONNX, который индексирует в 10–50 раз быстрее и не требует ключей. Он подходит для CI, например `codegraph-server --graph-only --run-tool codegraph_pr_context`.
Как выбрать модель эмбеддингов?
Флагом `--embedding-model`: `bge-small` по умолчанию, `jina-code-v2` в шесть раз медленнее, `granite-97m` с контекстом 32K и `static` на model2vec в сотню раз быстрее.
Что делать после обновления до 0.21?
Подождать: каждый проект один раз заново строит эмбеддинги в фоне, а поиск по ключевым словам работает во время перестройки. Демон `--watch` перезапустите.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыГраф зависимостей кода для VS Code, консоли и MCP: импорты, вызовы, циклы, неиспользуемый код и влияние правок.
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
CodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
CLI строит граф зависимостей на уровне функций для 34 языков и отдает его агенту через MCP-сервер из 34 инструментов.
Граф кода и память проекта в одной программе на Rust: агент получает выдержки из файлов со ссылкой на строки
MCP-сервер строит граф знаний о коде: поиск по смыслу, граф вызовов, трассировка HTTP-маршрутов и анализ влияния правок.
Коротко о README
Короткое описание и быстрый старт: MCP-сервер для Claude Code, расширение VS Code, плагин JetBrains, правила для агентов и GitHub Action для ревью запросов на слияние. Дальше заметки о переходе на 0.21, таблица флагов сервера и сведения о конфигурации.