Koragraph — MCP-сервер для Claude Code: граф кода и память
Строит локальный граф всех ваших репозиториев: кто кого вызывает, что сломается от правки. Память привязана к объявлениям в коде.
claude mcp add koragraph -- npx -y koragraphmcpЧто делает Koragraph
Koragraph индексирует репозитории, которые вы ему укажете, и собирает из них один граф: сервисы, файлы, эндпоинты, таблицы и настоящие вызовы между ними. Связи разрешаются по синтаксическому дереву, а не по совпадению имён, поэтому рёбра есть только там, где вызов действительно существует. Отдельно видны связи, переходящие из репозитория в репозиторий.
Второй слой — память. Найденные агентом факты, правила, ошибки и их исправления сохраняются локально и прикрепляются к конкретному объявлению в коде. Переименуйте функцию — факт переедет вместе с ней, удалите её — факт уйдёт. Вести CLAUDE.md вручную не нужно.
Установка: npm install -g koragraphmcp, затем koragraph ingest /path/to/repo и подключение через claude mcp add koragraph -- npx -y koragraphmcp. После этого в проекте нужно один раз попросить агента прочитать KORAINIT.md и выполнить шаги из него — без этого шага память не заработает. Нужен Node.js не ниже 22.
Инструменты доступны двумя путями: как MCP-вызовы в редакторе и как команды оболочки вроде koragraph blast src/pay.js или koragraph explore "how does checkout work". Граф в обоих случаях один. Только один инструмент пишет в память, остальные возвращают file:line.
Какие задачи решает
- посмотреть, что сломается от правки файла, ещё до самой правки
- найти все вызовы функции в нескольких репозиториях сразу
- разложить по полочкам найденные агентом ошибки и их исправления
- держать в памяти правила проекта, привязанные не к номеру строки, а к коду
- определить, что исторически меняется вместе с данным символом
Примеры запросов агенту
- Поставь koragraph для этого репозитория, проиндексируй его и доложи, сколько узлов и связей получилось
- Покажи через koragraph, что зависит от
src/pay.jsи где нет тестов - Прочитай
KORAINIT.mdи выполни всё, что там написано
Как установить Koragraph
Командой платформы
claude mcp add koragraph -- npx -y koragraphmcpКомандой платформы
codex mcp add koragraph -- npx -y koragraphmcpФайл настроек
{
"mcpServers": {
"koragraph": {
"command": "npx",
"args": [
"-y",
"koragraphmcp"
]
}
}
}Файл настроек
{
"servers": {
"koragraph": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"koragraphmcp"
]
}
}
}Командой платформы
gemini mcp add koragraph npx -y koragraphmcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Koragraph
Как установить Koragraph в Claude Code?
Сначала поставьте пакет и проиндексируйте репозиторий: npm install -g koragraphmcp, затем koragraph ingest /path/to/repo. После этого подключите сервер командой claude mcp add koragraph -- npx -y koragraphmcp и один раз прогоните KORAINIT.md в проекте.
Что делает Koragraph?
Собирает локальный граф всех указанных репозиториев вместе с вызовами и связями между ними. Плюс хранит память агента, привязанную к объявлениям в коде, и подчищает её, когда код меняется.
Что нужно для работы Koragraph?
Node.js версии 22 или выше. Сервер работает целиком на вашей машине. Для памяти в проекте нужно один раз выполнить инструкции из KORAINIT.md — без этого шага она не включится.
