kg — MCP-сервер графа знаний для Claude Code и Codex
Локальный MCP-сервер, который держит память проекта в виде графа знаний: узлы, связи, факты. Ассистент возвращается к этой памяти между сессиями, а не начинает с нуля.
Открыть на GitHubЧто делает kg
kg хранит знания о проекте не как набор текстовых фрагментов, а как граф: узлы с типами, рёбра с отношениями вроде DEPENDS_ON или TRIGGERS. Файлы *.kg лежат в ~/.kg/graphs, их можно читать глазами, сравнивать через diff и коммитить в git. Управление идёт через SCL — короткие команды с глаголом впереди: find, get, add, modify, connect, list nodes, stats, use <graph>. Идентификаторы строятся по схеме <type>:snake_case, тип выводится из префикса.
Отдельная возможность — собрать граф из каталога автоматически. Сервер обходит дерево файлов, распознаёт распространённые типы, вытаскивает символы из Rust, Java, JavaScript/TypeScript, Python и C/C++, а для markdown-подобных документов делает узлы GDOC и GSEC с содержимым разделов. Сгенерированный индекс хранится отдельно от ручного графа и его можно не добавлять в git.
Подключение — локальный stdio MCP-сервер: в конфиг клиента добавляется command с абсолютным путём до kg-mcp, после чего клиент перезапускают. Проект в статусе beta, так что API ещё меняются, а баги ожидаются — это повод не закладываться на текущий формат графа как на что-то застывшее. Установка идёт либо через cargo install kg-cli, либо скриптом из репозитория, либо готовым бинарником из GitHub Releases.
Какие задачи решает
- сохранить архитектурные решения проекта между сессиями ассистента
- собрать карту незнакомого репозитория без ручного моделирования
- найти узел по тексту и посмотреть его связи
- связать процессы, зависимости и правила явными рёбрами
- проверить, каких фактов в графе не хватает
Примеры запросов агенту
- Собери граф
paymentsиз документовdocs/payments/overview.mdиdocs/payments/retries.md, добавляй только факты из источников. - Посмотри граф
payments: как проходит авторизация платежа и что запускает повторные попытки? - Добавь узел
concept:smart_fridgeс описанием и свяжи его сprocess:compressor_controlотношениемTRIGGERS.
Как установить kg
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о kg
Как установить kg в Claude Code?
Установите CLI: cargo install kg-cli. Затем добавьте kg-mcp как локальный stdio MCP-сервер в конфиг клиента, указав абсолютный путь в поле command, и перезапустите клиент.
Что делает kg?
Даёт ассистенту постоянную память о проекте в виде графа: узлы, рёбра, факты и пробелы. Граф хранится локально в файлах *.kg, его можно просматривать, править и версионировать.
Чем kg отличается от RAG?
Классический RAG вытаскивает текстовые фрагменты из документов. kg держит явные факты, зависимости и связи, которые обновляются по ходу работы и читаются как структура, а не как подборка кусков текста.
