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-адресу.

Настройка клиентов

cursor
{
    "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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники