project-graph-mcp помогает ИИ-агентам видеть архитектуру проекта без лишних токенов

Для ИИ-агентов появился новый способ быстро разбираться в чужом коде: project-graph-mcp строит структурный граф проекта и отдает его в сжатом JSON. Вместо того чтобы читать десятки файлов подряд, агент получает карту архитектуры, видит зависимости и уже потом точечно углубляется в нужные места.

Как устроен сервер Ключевая идея project-graph-mcp — так называемый скелетон проекта.

Сервер парсит исходники, собирает сведения о файлах, классах, функциях, импортах и вызовах, а затем отдает все это в компактной структуре. По словам автора, сжатие достигает 10–50 раз, поэтому модель может понять общую архитектуру без огромного расхода контекста. Такой подход особенно полезен для агентных IDE и оркестраторов, которым нужно быстро решить, какой файл читать, куда делегировать подзадачу и как связаны модули между собой.

Сжатие получается в 10–50 раз.

Изначально инструмент работал только с JavaScript через AST-парсер Acorn, но в версии 1.1 получил поддержку TypeScript, Python и Go. Для новых языков автор выбрал regex-based подход: он проще, легче и не требует тянуть тяжелые внешние библиотеки ради базовой навигации по коду. При этом все парсеры приводятся к единому результату — спискам классов, функций, импортов и вызовов — чтобы агент работал с одной и той же моделью проекта независимо от стека.

Какие задачи закрывает На одном графе проект не заканчивается.

В сервер встроены вспомогательные инструменты анализа, которые позволяют не только ориентироваться, но и быстро находить проблемные места. Агент может понять, какие участки кода потенциально мертвы, где функция разрослась до неудобных размеров и по какой цепочке вызовов проходит запрос от middleware до рендера или обработчика API. Это делает сервер не просто картой проекта, а инструментом для первичной техдиагностики.

`get_dead_code` ищет неиспользуемые функции и модули `get_complexity` оценивает цикломатическую сложность `get_large_files` находит файлы-кандидаты на рефакторинг `get_call_chain` показывает путь между связанными функциями * Health Score собирает результаты проверок в оценку от 0 до 100 Отдельно в project-graph-mcp предусмотрены тестовые чеклисты через JSDoc-аннотации `@test` и `@expect`. Агент может получить список незакрытых проверок, написать код и затем пометить тест как пройденный. Это выглядит как мост между навигацией по проекту и реальным циклом разработки: сначала модель понимает структуру приложения, потом вносит изменения и сразу сверяется с ожидаемым поведением.

Для типовых стеков есть и встроенные правила: 11 наборов с 86 конвенциями для React, Vue, Express, TypeScript и Symbiote.js.

Интеграция и защита Инструмент задуман как часть более широкой агентной связки.

Автор описывает сценарий, в котором основной агент в IDE сначала запрашивает скелетон проекта, а затем делегирует отдельные задачи фоновым воркерам через agent-pool-mcp. Каждый воркер поднимает у себя такой же сервер и уже локально вызывает `expand`, `deps` и другие методы для конкретного участка кода. За счет этого оркестратор не таскает в контекст лишние файлы и может быстрее распределять работу между моделями с разной специализацией.

С точки зрения внедрения порог входа невысокий: нужен Node.js 18+, сервер запускается через `npx`, весит 132 КБ, состоит из 47 файлов и не имеет внешних зависимостей. На npm уже доступна версия 1.

2.0. Авторы также отдельно вынесли вопрос безопасности.

Все пути проходят проверку через `resolve` и `startsWith`, поэтому агент не может выйти за пределы рабочей директории. Если попробовать обратиться к чему-то вроде `../..

/etc/passwd`, сервер вернет ошибку. Для MCP-инструментов, которые читают файлы и зависимости, такая защита критична.

Что это значит ИИ-агенты постепенно переходят от простого

автодополнения к пониманию архитектуры целого проекта. project-graph-mcp интересен тем, что решает практическую проблему контекста: вместо сотен строк кода модель получает компактную карту системы и работает точнее. Для команд, которые строят собственных ИИ-агентов для разработки, это уже не эксперимент, а вполне прикладной слой инфраструктуры. Если подобные MCP-серверы станут стандартом, агентная разработка будет меньше упираться в лимиты токенов и чаще — в качество самой инженерной логики.