code-review-graph
Локальный граф структуры кода: строит карту репозитория через tree-sitter и отдает агенту по MCP только тот контекст, который относится к правке
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает исходники проекта и строит по ним локальную базу
- Ставит хуки и правит конфигурацию агентов при установке
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/code-review-graphОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio code-review-graph -- uvx code-review-graph serveИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"code-review-graph": {
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"code-review-graph": {
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"code-review-graph","type":"stdio","command":"uvx","args":["code-review-graph","serve"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"code-review-graph": {
"type": "stdio",
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add code-review-graph -- uvx code-review-graph serveИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.code-review-graph]
command = "uvx"
args = ["code-review-graph", "serve"]Если файл уже есть, допишите блок в конец.
Выполните в терминале
gemini mcp add -s user code-review-graph uvx code-review-graph serveИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"code-review-graph": {
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"code-review-graph": {
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"code-review-graph": {
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"code-review-graph": {
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"code-review-graph": {
"type": "local",
"command": [
"uvx",
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"code-review-graph": {
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"code-review-graph": {
"command": "uvx",
"args": [
"code-review-graph",
"serve"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Установи инструмент: pip install code-review-graph, затем code-review-graph install и code-review-graph build. После этого попроси меня командой построить граф ревью для проекта.
Другие способы из описания автора
pip install code-review-graph
code-review-graph install
code-review-graph buildinstall находит установленные агенты и прописывает им MCP-сервер, build разбирает код. Можно ставить через pipx install code-review-graph.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент разбирает исходники через tree-sitter и строит постоянный граф связей: функции, классы, вызовы, зависимости. Граф лежит локально в проекте и обновляется инкрементально через хуки и режим наблюдения, так что не нужно пересобирать его целиком после каждого коммита. По протоколу MCP агент запрашивает у графа компактный контекст вокруг изменения, вместо того чтобы перечитывать крупные части кодовой базы. Ставится как пакет с PyPI, команда install сама находит установленные редакторы и агенты и прописывает им MCP-сервер, хуки и правила. Есть встроенные бенчмарки экономии токенов, режим CLI и GitHub Action для ревью в пайплайне.
Для кого. Для разработчиков и ревьюеров, которые хотят, чтобы ассистент читал только нужные файлы при ревью и работе с большим репозиторием.
Подходит, если
- Ассистент тратит слишком много контекста, перечитывая большой репозиторий
- Нужно точно понять, что затрагивает конкретная правка, перед ревью
- Хочется отдавать агенту карту зависимостей по MCP, а не сырые файлы
Не подходит, если
- Маленький проект, где ассистент и так видит все файлы
- Язык проекта не поддерживается парсером tree-sitter из набора
Пример запроса к агенту
Построй граф ревью для этого проекта и покажи, что затрагивает моя правкаОграничения
Нужен Python 3.10 или новее. Первичная сборка занимает время и растет с размером репозитория, часть файлов может не распарситься и тогда сборка помечается как частичная. Структурный граф работает локально без внешних ключей. Семантический поиск по эмбеддингам это отдельная опция, для нее нужен ключ провайдера эмбеддингов или локальный шлюз вроде Ollama в режиме OpenAI.
Как отключить. Выполните code-review-graph uninstall в корне репозитория, команда убирает свои файлы и записи MCP и не трогает чужие серверы и хуки. Флаг --dry-run покажет изменения без применения.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| CRG_OPENAI_API_KEY секрет | Ключ для эмбеддингов через OpenAI-совместимый эндпоинт, нужен только для семантического поиска |
| CRG_OPENAI_BASE_URL | Адрес OpenAI-совместимого эндпоинта эмбеддингов, например локального шлюза |
Проверка безопасности
- Читает исходники проекта и строит по ним локальную базу
- Ставит хуки и правит конфигурацию агентов при установке
Коротко о README
README объясняет, что ассистенты часто перечитывают большие части кода ради одной правки, и предлагает вместо этого граф структуры на tree-sitter, который отдает компактный контекст по MCP. Быстрый старт из трех шагов: установка с PyPI, команда install для автонастройки редакторов и build для разбора кода. Команда uninstall аккуратно снимает интеграцию и не трогает чужие настройки. Отдельно описаны провайдеры эмбеддингов для семантического поиска, воспроизводимые бенчмарки экономии токенов и GitHub Action. Лицензия MIT, требуется Python 3.10 и новее.
Частые вопросы
Данные уходят наружу?
Структурный граф строится и хранится локально, без внешних ключей. Наружу что-то идет только если вы включили семантические эмбеддинги с ключом провайдера или через локальный шлюз.
С какими агентами работает?
Команда install умеет настраивать несколько редакторов и агентов, среди них Claude Code, Codex, Cursor, Windsurf, OpenCode, Gemini CLI и GitHub Copilot. Можно указать один через флаг --platform.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything