repo2graph — MCP-сервер для Claude Code: что делает и как установить
Строит граф связей кодовой базы через Tree-sitter и BM25, возвращая фрагменты кода с номерами строк в рамках лимита токенов. Пригодится агентам для навигации по зависимостям.
claude mcp add repo2graph -- uvx repo2graphЧто делает repo2graph
Утилита разбирает проект за один проход Tree-sitter, фиксируя импорты, цепочки вызовов и историю совместных изменений файлов в Git. Поиск стартует с текстового сопоставления BM25, после чего обходит найденные связи в графе и укладывает результат в заданный бюджет токенов. Каждая выжимка кода сопровождается заголовком с путём к файлу и номерами строк вида [cite: path:start-end].
Базовый режим работает автономно: серверу не нужны внешние API, сторонние базы данных или запущенный языковой сервер. Грамматики парсеров уже скомпилированы внутри пакета tree-sitter-language-pack. Сетевые запросы происходят лишь при явном клонировании репозиториев с GitHub, передаче контекста в модель через опцию --answer или первой загрузке векторных эмбеддингов.
Сервер выигрывает у обычного поиска по тексту на сложных межфайловых цепочках, но на простых запросах внутри одного файла grep остаётся точнее.
Какие задачи решает
- отслеживать цепочки вызовов и импортов между модулями
- получать фрагменты кода с точными ссылками на строки
- укладывать контекст кодовой базы в жёсткий лимит токенов
- исследовать архитектуру проекта без отправки кода во внешние сервисы
Примеры запросов агенту
- Покажи, как устроен роутинг запросов и какие функции он вызывает.
- Найди определение базового класса и покажи все модули, которые его импортируют.
- Объясни обработку ошибок в проекте, опираясь на граф вызовов.
Как установить repo2graph
Командой платформы
claude mcp add repo2graph -- uvx repo2graphuvx запускает команду с именем пакета; если в README она другая — uvx --from repo2graph <команда>
Командой платформы
codex mcp add repo2graph -- uvx repo2graphuvx запускает команду с именем пакета; если в README она другая — uvx --from repo2graph <команда>
Файл настроек
{
"mcpServers": {
"repo2graph": {
"command": "uvx",
"args": [
"repo2graph"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from repo2graph <команда>
Файл настроек
{
"servers": {
"repo2graph": {
"type": "stdio",
"command": "uvx",
"args": [
"repo2graph"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from repo2graph <команда>
Командой платформы
gemini mcp add repo2graph uvx repo2graphuvx запускает команду с именем пакета; если в README она другая — uvx --from repo2graph <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о repo2graph
Как установить repo2graph в Claude Code?
Выполните команду claude mcp add repo2graph -- uvx repo2graph. Для запуска потребуется менеджер пакетов uv.
Что делает repo2graph?
Инструмент анализирует зависимости в проекте с помощью Tree-sitter и Git. По запросу он находит отправные точки через BM25, обходит рёбра графа и возвращает агенту цитаты кода с указанием файлов и строк.
Нужен ли API-ключ для работы сервера?
Нет, построение индекса и локальный поиск работают без внешних ключей и баз данных. Доступ к сети требуется только при клонировании репозиториев с GitHub или скачивании опциональных моделей для векторного поиска.
