Kappa Graph MCP
Граф знаний с MCP-сервером: агент ищет понятия по смыслу, видит, насколько они подтверждены, и находит спорные места в источниках.
- 131 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инструменты `graph`, `ingest` и `ontology` могут добавлять, менять и удалять данные платформы.
- Тексты документов уходят выбранной языковой модели при извлечении понятий.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/aaronsb/knowledge-graph-system/main/client-manager.sh | bashПервый способ из README ставит CLI `kg`, MCP-сервер и FUSE; только CLI: `npm install -g @aaronsb/kg-cli`. Платформа разворачивается отдельно через `./operator.sh`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструменты `graph`, `ingest` и `ontology` могут добавлять, менять и удалять данные платформы.
- Тексты документов уходят выбранной языковой модели при извлечении понятий.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Kappa Graph (репозиторий `knowledge-graph-system`) извлекает из документов понятия, связи и свидетельства, сохраняет их в графе на PostgreSQL с Apache AGE и для каждого понятия считает оценку обоснованности от -1 до 1. Противоречащие источники сохраняются рядом, а не склеиваются. MCP-сервер `kg-mcp-server` дает агенту инструменты `search`, `concept`, `ontology`, `job`, `ingest`, `source`, `graph`, `program`, `document` и другие: поиск по смыслу, обход связей, пути между понятиями, загрузка текста, управление заданиями. Платформу разворачивают у себя через `./operator.sh init` и `./operator.sh start`. Клиентские инструменты (CLI `kg`, MCP-сервер и файловая система FUSE) ставит скрипт `client-manager.sh`.
Для кого. Исследователи и инженеры, которые копят документы и хотят дать агенту память с оценкой надежности и ссылкой на источник.
Подходит, если
- Агент должен отвечать по большому набору статей и показывать, на чем держится вывод.
- В заметках и отчетах надо найти места, где источники спорят друг с другом.
- Между двумя понятиями нужно найти кратчайшую цепочку связей.
- Тексты и изображения из проекта загружают в общую онтологию.
Не подходит, если
- Нужен один MCP-сервер без развертывания платформы и контейнеров.
- Документы нельзя отправлять облачной языковой модели, а локальной Ollama нет.
- Агенту нельзя доверять изменение и удаление понятий графа.
Пример запроса к агенту
Какие понятия связаны с распределенными системами, насколько они подтверждены, и найди кратчайший путь от «технический долг» до «продуктивность команды».MCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
KG_API_URLобязательная- Адрес API платформы, например `http://localhost:8000`.
KG_OAUTH_CLIENT_IDобязательная- Идентификатор OAuth-клиента, созданного `kg oauth create-mcp`.
KG_OAUTH_CLIENT_SECRETобязательная, секрет- Секрет OAuth-клиента, показывается один раз при создании.
Ограничения
Нужна работающая платформа: контейнеры, PostgreSQL и своя установка, а не только MCP-сервер. Для извлечения понятий используется языковая модель: облачный провайдер получает текст документов, локальный вариант идет через Ollama. Нужны Node.js 20.12.0 или новее и OAuth-клиент, созданный командой `kg oauth create-mcp`; секрет показывается один раз. MCP-сервер ставится вместе с CLI `kg`, поэтому нужны и клиентские инструменты, и запущенный бэкенд платформы.
Как отключить. Удалите сервер командой `claude mcp remove knowledge-graph` либо правкой `claude_desktop_config.json` и удалите OAuth-клиент из платформы. Саму платформу останавливает `./operator.sh stop`.
Частые вопросы
Что такое оценка обоснованности?
Это число от -1 до 1: поддерживающие свидетельства поднимают ее, противоречащие снижают. Понятие с одним нерассмотренным упоминанием получает другую оценку, чем понятие с десятками источников.
Как создать учетные данные для MCP?
Выполните `kg login`, затем `kg oauth create-mcp`. Команда выведет `KG_OAUTH_CLIENT_ID` и `KG_OAUTH_CLIENT_SECRET`; секрет виден только один раз. Короткие токены на час сервер обновляет сам.
Можно ли работать без облачных моделей?
Да, платформа поддерживает локальный вывод через Ollama, поэтому развертывание может обходиться без внешних сервисов.
Какие файлы можно загружать?
PDF, Markdown, изображения и обычный текст. Из них извлекаются понятия, связи и свидетельства, а исходный фрагмент остается привязан к каждому понятию.
Что такое файловая система FUSE?
Необязательный клиент, который монтирует граф как каталог: `ls`, `grep` и `find` работают по смысловому пространству. Его ставит тот же скрипт `client-manager.sh`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для платформы GraphRAG: загрузка документов из 14 источников, гибридный поиск и ответы ИИ по графу знаний
CLI и MCP-сервер для извлечения структурированных знаний из документов: графы, гиперграфы и поиск по фактам с источниками
Graphlit MCP Server — база знаний для агента
Graphlit MCP Server
Официальный MCP-сервер Graphlit: агент собирает материалы из Slack, GitHub, почты и сайтов в базу знаний и ищет по ней
MCP-сервер InfraNodus строит из текста граф знаний и показывает кластеры тем, пробелы между ними и вопросы для исследования
Локальный MCP-сервер, который превращает папку с документами в базу знаний с гибридным поиском для Claude Code и Cursor
Графовая база с ветвями как в git: сервер отдает ее агентам по MCP на /mcp, а встроенный скилл учит агента схемам, запросам и политикам
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Kappa Graph (эта карточка) | нет | OAuth | 131 | |
| Cognee | нет | 33 093 | граф знаний для памяти агентов; в Kappa Graph каждое понятие получает оценку обоснованности, а противоречия между источниками сохраняются | |
| Graphiti MCP | нет | API-ключ | 32 574 | временной граф знаний через MCP; Kappa Graph строит онтологию из документов и измеряет обоснованность понятий |
Коротко о README
В README есть быстрый старт клиентских инструментов и платформы, архитектуру на PostgreSQL с Apache AGE и расширением `graph_accel`, сравнение с GraphRAG, Zep/Graphiti и Cognee, а также документацию из 96 архитектурных решений.