Code-Graph-MCP: Открытый MCP-сервер сокращает использование токенов кода в Claude на 40-60%

code-graph-mcp — это открытый MCP-сервер, который индексирует кодовые базы в граф знаний AST, чтобы снизить использование токенов Claude Code. Вместо того чтобы Claude делал множество вызовов grep/read/glob для понимания структуры кода, он запрашивает граф для получения структурированных ответов в единичных вызовах.

Как это работает

Инструмент парсит код с помощью Tree-sitter, извлекает символы (функции, классы, типы, интерфейсы) и их связи (вызовы, импорты, наследование, экспорты, привязки HTTP-маршрутов), затем сохраняет всё в SQLite с полнотекстовым поиском FTS5 и sqlite-vec для векторного сходства. Поддерживает 10 языков: TypeScript, JavaScript, Go, Python, Rust, Java, C, C++, HTML и CSS.

Ключевые инструменты

• project_map — Полный обзор архитектуры в одном вызове (модули, зависимости, горячие функции, точки входа)
• semantic_code_search — Гибридный поиск, сочетающий BM25 + векторное сходство с RRF-фьюжном
• get_call_graph — Трассировка вызывающих/вызываемых функций с рекурсивными CTE
• impact_analysis — Увидеть всё, что зависит от функции, перед её изменением
• trace_http_chain — Трассировка HTTP-маршрутов от обработчика до вызова БД (поддерживает Express, Flask/FastAPI, Go)
• module_overview, dependency_graph, find_similar_code, get_ast_node — Дополнительные функции инструментария

Результаты эффективности

На проекте из 33 файлов на Rust:

• Понимание архитектуры проекта: Сокращено с 5–8 вызовов инструментов до 1 вызова
• Трассировка цепочки вызовов на 2 уровня: Сокращено с 8–15 вызовов до 1 вызова
• Анализ влияния перед изменением: Сокращено с 10–20+ вызовов до 1 вызова
• Поиск функции по концепции: Сокращено с 3–5 вызовов до 1 вызова

В целом: ~80% меньше вызовов инструментов на задачу навигации, ~95% меньше исходного кода, сбрасываемого в контекст, и экономия 40–60% общих токенов сессии.

Технические детали

Инкрементальная индексация использует дерево Меркла BLAKE3 для отслеживания хешей содержимого — перепарсиваются только изменённые файлы. Неизменённые поддеревья каталогов полностью пропускаются через кэш mtime. При изменении сигнатуры функции грязное распространение автоматически перегенерирует контекст для всех нижестоящих вызывающих.

Инструмент не имеет внешних зависимостей — это единичный бинарник 19 МБ со встроенным SQLite и встроенным sqlite-vec. Не требуется Docker, облачный API или сервер БД. Опциональные локальные эмбеддинги используют модель эмбеддингов на основе Candle, защищённую фича-гейтом, так что можно собрать без неё, если векторный поиск не нужен.

Установка

Работает с Claude Code, Cursor, Windsurf или любым MCP-клиентом.

Плагин Claude Code (рекомендуется):

/plugin marketplace add sdsrss/code-graph-mcp
/plugin install code-graph-mcp

Включает MCP-сервер плюс слэш-команды (/understand, /trace, /impact), хуки автоиндексации (переиндексация при каждом редактировании файла), отображение состояния StatusLine и автоматические обновления.

Для любого MCP-клиента:

npx -y @sdsrs/code-graph

Или добавьте в конфиг MCP:

{
  "mcpServers": {
    "code-graph": {
      "command": "npx",
      "args": ["-y", "@sdsrs/code-graph"]
    }
  }
}

Когда не стоит использовать

grep всё ещё лучше для точного поиска строк/констант. Если нужно найти каждое вхождение TODO или конкретный код ошибки, используйте grep. code-graph-mcp сияет, когда нужно понять структуру, связи и архитектуру кода.