Разработчик Илья (никнейм на Habr) выпустил graphlens-mcp — инструмент, который позволяет подключить структурный граф кода к ИИ-агентам (Claude Code, Cursor, Copilot и другим) одной командой. graphlens-mcp появился как ответ на проблему, с которой сталкиваются все, кто использует кодовых агентов на больших проектах: сотни тысяч строк кода, grep и циклы открытия файлов приводят к колоссальному расходу токенов. Anthropic в инженерном блоге прямо указывает, что определения инструментов и промежуточные результаты могут «consume 50,000+ tokens before an agent reads a request» — и это до того, как агент начал думать над задачей.
Структурный граф, который строит graphlens, решает эту проблему принципиально иначе. Вместо «прочитай файл и поищи глазами» агент задаёт точный вопрос — например, «кто вызывает create_order?» — и получает компактный структурированный ответ. Механизм graphlens нормализует исходники на Python, TypeScript, Go, Rust и PHP в единый типизированный граф с узлами-символами и type-aware рёбрами (CALLS, HAS_TYPE, INHERITS_FROM), используя детерминированные SHA-256 ID для каждого узла. Ранее автор провёл бенчмарк на 936 прогонах с apache/superset (~400k строк) и показал, что на задачах анализа влияния структурный граф в 10–23 раза дешевле grep, хотя на точечных запросах разница почти нулевая.
| Инструмент | Назначение |
|---|---|
| search_symbol | Поиск символа по имени |
| describe_symbol | Получение описания символа (тип, сигнатура, документация) |
| compute_impact | Определение того, что сломается при изменении узла |
| follow_import | Переход по импорту к целевому модулю |
| search_string | Поиск строки в коде с контекстом |
| search_regex | Поиск по регулярному выражению |
| get_file | Получение содержимого файла |
| all_nodes | Поиск всех узлов графа |
Однако движок — это не продукт. Чтобы использовать graphlens в реальной работе, нужно написать glue-код: хранилище графа, инвалидацию, watcher, MCP-сервер с инструментами, регистрацию в конфигах разных агентов и навигационный скилл. graphlens-mcp — это законченный продукт, который берёт на себя всю эту обвязку. Установка выполняется одной командой — uv tool install graphlens-mcp или pipx install graphlens-mcp. Затем в корне проекта запускается graphlens-mcp init, который определяет языки, индексирует код, прописывает
Сервер graphlens-mcp выставляет восемь инструментов, нарезанных под конкретные запросы о коде: поиск символа по имени, описание символа, определение влияния изменений, переход по импорту, поиск по строке, поиск по регулярному выражению, получение содержимого файла и поиск всех узлов графа. Каждый инструмент возвращает минимальный объём данных, а не весь файл, что резко сокращает потребление токенов. Проект распространяется под лицензией MIT, текущая версия — 0.1.2, требуется Python ≥ 3.13.
