repo-graph
repo-graph — MCP-сервер сообщества (автор — James-Chahwan). Структурная карта кодовой базы для навигации LLM. Ставится через uvx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- James-Chahwan
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- python
Уровень риска: medium
Читает код репозитория, пишет кеш графа в .glia/graph/; сеть только для клонирования по git-адресу.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"repo-graph\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-repo-graph\", \"--repo\", \"/path/to/your/project\"]\n }\n }\n}",
"file": ".cursor/mcp.json",
"lang": "json",
"verified": "docs"
}
Что умеет
repo-graph — структурная графовая память для ИИ-ассистентов программиста. Он даёт модели карту кодовой базы — сущности, связи и потоки, — чтобы она находила нужные файлы, не читая всё подряд. Вместо того чтобы заливать в контекст весь код или надеяться на удачную догадку, repo-graph строит лёгкий граф того, что есть, как это связано и где точки входа. Модель запрашивает граф, находит минимальный набор файлов и читает только их.
Что попадает в граф:
- сущности — модули, пакеты, классы, функции, маршруты, сервисы, компоненты;
- связи — импорты, вызовы, обработчики, определения, вложенность, HTTP-вызовы между стеками;
- потоки — сквозные пути от точки входа до слоя данных.
Шесть инструментов: orient (языки, основные части, слепые зоны графа), trace (путь от точки входа до базы данных), impact (радиус поражения изменения, в том числе для всего диффа), find (узлы, относящиеся к ошибке или трассировке стека), read (исходный код функции) и refresh (пересборка после большого рефакторинга). Если ответ пустой, сервер объясняет почему — по замерам авторов, это сократило стоимость примерно втрое на одинаковых задачах.
Где полезнее всего: большие репозитории, монорепозитории на нескольких языках и многосервисные системы. Например, вызов фронтенда связывается с маршрутом бэкенда и обработчиком за ним, хотя у двух сторон нет общей строки для текстового поиска. Поддерживаются Go, Rust, TypeScript, React, Python, Java, C#, PHP, Ruby и другие, а также gRPC, GraphQL, WebSocket, очереди и события. На маленьком проекте на одном языке граф избыточен: модель может просто прочитать файлы.
Как устроен: тонкий Python-сервер поверх движка glia на Rust — разбор через tree-sitter, извлечение маршрутов и сервисов, связывание стеков, хранение графа в .glia/graph/. Пока сервер работает, он следит за репозиторием и пересобирает только изменённые части.
Кому подойдёт
Командам с крупными и запутанными кодовыми базами, которым важно, чтобы агент не тратил контекст на ориентирование. Похожие серверы — в категории разработка.
Установка
Нужны Python 3.11+ и uv. Колёса движка собраны для Linux, macOS и Windows, Rust не нужен. Одна команда uvx mcp-repo-graph install настраивает всех найденных агентов; флаг --dry-run покажет изменения, uninstall всё откатит. Каждый инструмент доступен и как команда оболочки, например uvx mcp-repo-graph orient.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add repo-graph -- uvx mcp-repo-graph --repo .Флаг --repo . указывает на текущий проект; для фиксации используйте абсолютный путь. Параметр принимает и git-адрес публичного репозитория — тогда сервер сам сделает неглубокий клон. Для Cursor блок добавляют в .cursor/mcp.json. В Claude Code есть и плагин с сервером и навыками.
Проверка
Спросите агента: «Что делает этот репозиторий?» — он вызовет orient.
Примеры задач
Проследи поток оформления заказа от маршрута до базы данных.Что сломается, если поменять UserService?Риски
- Чтение кода выбранного репозитория; кеш графа записывается в
.glia/graph/. - Сеть — только при указании git-адреса для клонирования.
- Наблюдатель за файлами расходует память; отключается переменной
REPO_GRAPH_WATCH=0.
Частые вопросы
Нужен ли Rust?
Нет, есть готовые сборки.
Стоит ли ставить на маленький проект?
Обычно нет, выигрыш на больших и многоязычных кодовых базах.
Как держать граф свежим?
Сервер обновляет его сам при сохранении файлов.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.