znt-kg-mcp

Model Context Protocol (MCP) сервер для Znt Knowledge Graph Engine (znt-kg).

Позволяет AI-агентам в Cursor, Claude Desktop, Antigravity, Windsurf и других средах напрямую работать с локальным графом знаний, выполнять гибридный поиск, строить визуализации связей и отправлять безопасные Read-Only SQL запросы.

🚀 Быстрый старт

1. Запуск демона znt-kg

Убедитесь, что сервер базы знаний запущен и слушает сокет ~/.znt/kg.sock:

cd /Users/bootta/www/Znt/znt-kg
./znt-kg --config config.yaml

2. Конфигурация в AI-агентах (MCP Settings)

Добавьте конфигурацию сервера в ваш claude_desktop_config.json, .cursor/mcp.json или конфигурацию Antigravity:

{
  "mcpServers": {
    "znt-kg": {
      "command": "node",
      "args": ["/Users/bootta/www/Znt/znt-kg-mcp/index.js"],
      "env": {
        "ZNT_KG_SOCKET": "/Users/bootta/.znt/kg.sock"
      }
    }
  }
}

🛠 Доступные инструменты (Tools)

| Инструмент | Описание | |---|---| | kg_add_nodes | Добавление сущностей или обновление среза по anchor_id с архивацией в node_history. | | kg_add_edges | Создание связей с обязательной проверкой from_name и to_name (защита от галлюцинаций в ID). | | kg_get_node_history | Просмотр хронологической истории изменений узла. | | kg_query_sql | Выполнение безопасных Read-Only SQL-запросов (mode=ro). Мутации заблокированы. | | kg_search | Гибридный (BM25 FTS5 + Vector RRF), лексический или векторный поиск. | | kg_subgraph | Окрестности сущности (target) или кратчайший путь (trace) с выводом в Mermaid. | | kg_find_similar | Векторный KNN-поиск семантически близких сущностей. | | kg_status | Статистика по узлам, рёбрам, очереди векторизации и пути к базе. |