gctrl — MCP-сервер для Claude Code: что делает и как установить
gctrl подключает ИИ-агента к графу знаний, гибридному поиску и инструментам анализа кода. Нужен для работы с контекстом проекта и сохранения решений.
claude mcp add --env GCTRL_GATEWAY_URL=<GCTRL_GATEWAY_URL> --env GCTRL_API_URL=<GCTRL_API_URL> --env GCTRL_API_TOKEN=<GCTRL_API_TOKEN> --transport stdio mcp -- npx -y gctrl-mcpЧто делает gctrl
gctrl даёт агенту инструменты для извлечения знаний из текста в сущности Neo4j и векторы Qdrant, запросов к графу через гибридный поиск, поиска сущностей, объединения результатов и хранения заметок с выделением знаний. Отдельные инструменты показывают схемы, онтологии, графы и задания извлечения.
В прямом режиме сервер умеет индексировать локальный репозиторий и искать символы, связи между вызывающими и вызываемыми функциями, затронутые файлы и архитектурные сведения. Для gctrl_code_index нужен пакет gctrl-code-indexer; остальные инструменты продолжают работать без него. Доступ задаётся через GCTRL_API_TOKEN, а сервер подключается к GCTRL через GCTRL_GATEWAY_URL или GCTRL_API_URL.
Без запущенного GCTRL harness сервер не сможет работать через шлюз. Старые имена borghive_* пока служат псевдонимами, но при каждом вызове пишут предупреждение и будут удалены в v2.0.
Какие задачи решает
- извлечь сущности и связи из текста
- задать вопрос по графу знаний
- найти сущность по имени или типу
- объединить результаты нескольких извлечений
- проиндексировать локальный репозиторий и найти символ
Примеры запросов агенту
- Извлеки из
architecture.mdсущности и связи, затем сохрани результат в граф знаний. - Найди в графе все сведения о сервисе платежей и объясни связанные зависимости.
- Проиндексируй текущий репозиторий, найди символ
UserServiceи покажи его вызывающие функции.
Как установить gctrl
Командой платформы
claude mcp add --env GCTRL_GATEWAY_URL=<GCTRL_GATEWAY_URL> --env GCTRL_API_URL=<GCTRL_API_URL> --env GCTRL_API_TOKEN=<GCTRL_API_TOKEN> --transport stdio mcp -- npx -y gctrl-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp --env GCTRL_GATEWAY_URL=<GCTRL_GATEWAY_URL> --env GCTRL_API_URL=<GCTRL_API_URL> --env GCTRL_API_TOKEN=<GCTRL_API_TOKEN> -- npx -y gctrl-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_GATEWAY_URL": "<GCTRL_GATEWAY_URL>",
"GCTRL_API_URL": "<GCTRL_API_URL>",
"GCTRL_API_TOKEN": "<GCTRL_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gctrl-mcp"
],
"env": {
"GCTRL_GATEWAY_URL": "<GCTRL_GATEWAY_URL>",
"GCTRL_API_URL": "<GCTRL_API_URL>",
"GCTRL_API_TOKEN": "<GCTRL_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GCTRL_GATEWAY_URL=<GCTRL_GATEWAY_URL> -e GCTRL_API_URL=<GCTRL_API_URL> -e GCTRL_API_TOKEN=<GCTRL_API_TOKEN> mcp npx -y gctrl-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gctrl
Как установить gctrl в Claude Code?
Выполните claude mcp add gctrl -e GCTRL_API_TOKEN=<GCTRL_API_TOKEN> -- npx -y gctrl-mcp. Для работы серверу нужен запущенный GCTRL harness.
Что делает gctrl?
MCP-сервер подключает агента к графам знаний, гибридному поиску, извлечению и слиянию знаний. В прямом режиме он также предоставляет инструменты индексации и анализа кода.
Что нужно для работы gctrl_code_index?
Нужен прямой режим и пакет gctrl-code-indexer. Без этого пакета инструмент вернёт подсказку по установке, а остальные инструменты продолжат работать.
