code-graph-mcp
MCP-сервер строит граф знаний о коде: поиск по смыслу, граф вызовов, трассировка HTTP-маршрутов и анализ влияния правок.
- 95 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает весь исходный код проекта и держит локальный индекс, при плагине ставит хуки на правки файлов
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/code-graph-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает весь исходный код проекта и держит локальный индекс, при плагине ставит хуки на правки файлов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
code-graph-mcp индексирует кодовую базу в структурированный граф на основе дерева разбора Tree-sitter. Агент получает инструменты поиска по смыслу, обхода графа вызовов в обе стороны, поиска ссылок, трассировки HTTP-маршрутов до функций-обработчиков и поиска мертвого кода. Анализ влияния показывает, что заденет правка. Глубокий разбор с вызовами, импортами и наследованием есть для TypeScript, JavaScript, Go, Python, Rust и Java, а для C#, Kotlin, Ruby, PHP, Swift и Dart он проверен выборочно. Поиск совмещает BM25 и векторное сходство через `sqlite-vec`. Индекс обновляется инкрементально по дереву Меркла, а ответы сжимаются по уровням, чтобы экономить токены контекста.
Для кого. Разработчикам больших кодовых баз, где агент тратит десятки вызовов на чтение файлов и хочет сразу получить структуру.
Подходит, если
- Нужно найти функцию по описанию ее смысла и получить ее за один вызов.
- Требуется проследить цепочку вызовов на два уровня вглубь до начала рефакторинга.
- Надо понять, какой обработчик отвечает за маршрут Express, Flask, FastAPI, `net/http` или `axum`.
- Перед удалением кода стоит найти неиспользуемые символы и оценить зону поражения правки.
Не подходит, если
- Проект маленький, и агенту проще открыть пару файлов, чем поддерживать индекс.
- Язык вне списка: для HTML, CSS и JSON работает только полнотекстовый поиск по файлам.
- Нужен маршрут на `actix`, `rocket` или Java Spring: эти фреймворки пока не разбираются.
Пример запроса к агенту
Через code-graph найди, где в проекте обрабатывается оплата, и покажи, какие функции вызывают этот обработчик.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Глубина разбора зависит от языка: полный уровень у шести языков, выборочный у шести других, а C и C++ поддержаны ограниченно. Маршруты извлекаются из Express и Connect, Go `net/http`, Flask, FastAPI и `axum`. Фреймворки `actix`, `rocket` и Java Spring пока не разбираются. Индекс хранится локально и обновляется при следующем запросе инструмента после правки файлов. Стоит учитывать нагрузку на диск и процессор при первом индексировании крупного проекта. Рекомендуемый способ установки идет через плагин Claude Code, остальным клиентам хватает конфигурации MCP.
Как отключить. Удалите плагин командой `/plugin uninstall code-graph-mcp` или уберите сервер через `claude mcp remove code-graph-mcp`. Локальный индекс стирают вручную.
Частые вопросы
Чем плагин лучше голого MCP?
Плагин добавляет скиллы `explore` и `index`, агента `code-explorer`, автоиндексацию, строку статуса и обновления. MCP-режим дает только инструменты.
Как подключить к Cursor или Windsurf?
Через конфигурацию MCP с командой `npx` и пакетом `@sdsrs/code-graph`. Другие варианты: `npx -y @sdsrs/code-graph` или глобальный `npm install -g @sdsrs/code-graph`.
Как сэкономить токены?
Почти каждый инструмент принимает `compact: true`, который убирает тела кода из ответа. Автор приводит выигрыш до 75–90 процентов на сопоставимых задачах.
Когда обновляется индекс?
Наблюдатель за файлами помечает правки, а следующий запрос к инструментам графа переиндексирует их перед ответом. `get_index_status` индексацию не запускает.
Что такое поиск гибридного типа?
Совмещение полнотекстового BM25 и векторного поиска через `sqlite-vec` с слиянием рангов RRF.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который строит граф кода: функции, классы, вызовы и маршруты, и отвечает на структурные запросы агента локально
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
Deep Graph MCP — граф кода репозитория для агента
Deep Graph MCP
MCP-сервер дает агенту граф кода репозитория: поиск функций по смыслу, связи символов и список мест, которые заденет правка
MCP-сервер, который превращает большую кодовую базу в семантический граф функций для точной навигации и поиска по смыслу
Граф зависимостей кода для VS Code, консоли и MCP: импорты, вызовы, циклы, неиспользуемый код и влияние правок.
Коротко о README
README перечисляет языки и глубину разбора, возможности графа, три способа установки и бенчмарки по числу вызовов. Для Claude Code рекомендован плагин.