GraphPilot — MCP-сервер для Claude Code: граф кода и установка
GraphPilot строит локальный граф TypeScript/JavaScript-кода и отдаёт агенту связи между символами, вызовами и затронутыми файлами.
claude mcp add --env GRAPHPILOT_ROOT=<GRAPHPILOT_ROOT> --transport stdio graphpilot -- npx -y @graphpilot-oss/graphpilotЧто делает GraphPilot
GraphPilot индексирует репозиторий TypeScript или JavaScript: разбирает файлы через tree-sitter, находит символы и связи вызовов, а затем сохраняет граф на диске. MCP-сервер предоставляет агенту структурные запросы о вызывающих и вызываемых функциях, символах и зоне влияния изменений.
CLI работает отдельно от MCP-сервера. Команда graphpilot index <path> создаёт индекс, graphpilot watch <path> поддерживает его свежесть, а graphpilot mcp читает готовый граф и общается с агентом через stdio. Индексы учитывают git worktree и могут различаться между ветками.
GraphPilot работает локально, без телеметрии и удалённых вызовов. Нужны Node.js ≥20 и репозиторий TypeScript/JavaScript; MCP-сервер сам индекс не строит, поэтому перед первым запросом нужно выполнить graphpilot index <path>.
Какие задачи решает
- найти вызывающие и вызываемые функции
- оценить файлы, затронутые переименованием символа
- проверить связи между символами в репозитории
- сопоставить структурный запрос с конкретными строками кода
Примеры запросов агенту
- Покажи, какие функции вызывают
parseConfig, и укажи файлы со строками. - Оцени зону влияния переименования
UserServiceв текущей ветке. - Найди символы и связи вызовов, связанные с
src/router.ts.
Как установить GraphPilot
Командой платформы
claude mcp add --env GRAPHPILOT_ROOT=<GRAPHPILOT_ROOT> --transport stdio graphpilot -- npx -y @graphpilot-oss/graphpilotВместо <…> подставьте свои значения
Командой платформы
codex mcp add graphpilot --env GRAPHPILOT_ROOT=<GRAPHPILOT_ROOT> -- npx -y @graphpilot-oss/graphpilotВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"graphpilot": {
"command": "npx",
"args": [
"-y",
"@graphpilot-oss/graphpilot"
],
"env": {
"GRAPHPILOT_ROOT": "<GRAPHPILOT_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"graphpilot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@graphpilot-oss/graphpilot"
],
"env": {
"GRAPHPILOT_ROOT": "<GRAPHPILOT_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GRAPHPILOT_ROOT=<GRAPHPILOT_ROOT> graphpilot npx -y @graphpilot-oss/graphpilotВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о GraphPilot
Как установить GraphPilot в Claude Code?
Выполните claude mcp add graphpilot -- npx -y @graphpilot-oss/graphpilot. Затем создайте индекс проекта командой graphpilot index <path>.
Что делает GraphPilot?
Он строит локальный граф TypeScript/JavaScript-кода с символами, вызывающими и вызываемыми функциями, а MCP-сервер отдаёт эти данные coding-агенту.
Что нужно подготовить для работы GraphPilot?
Нужны Node.js ≥20 и репозиторий TypeScript или JavaScript. Сначала создайте индекс через graphpilot index <path>, потому что MCP-сервер читает готовый граф.
