kg MCP server

kg - local knowledge graph for your AI assistants

Beta - APIs may still change and some bugs are still expected.

kg gives your AI assistant persistent, structured, editable project memory stored locally as a knowledge graph.

Instead of relying only on document chunk retrieval, you can keep architecture, decisions, incidents, rules, dependencies, and workflows in a graph that is readable, reviewable, and Git-friendly.

Use it when you want your assistant to understand an existing project across sessions — not start from zero every time.

Why use it

• Persistent memory — keep project knowledge between conversations
• Structured, not fuzzy — inspect nodes, edges, facts, and gaps directly
• Editable and reviewable — store graphs as *.kg files with readable diffs
• Local-first — your project memory stays on your machine in git-friendly format
• Works with MCP clients — connect it as a local stdio MCP server

Why not just RAG

Classic RAG is good for retrieving text chunks from documents.

kg-mcp is better when you want:

• stable project memory instead of repeated retrieval
• explicit facts, relations, and dependencies
• graph updates during real work with the assistant
• something you can inspect, version, diff, and improve over time

Installation

From crates.io

cargo install kg-cli

From script

Recommended install:

curl -sSL https://raw.githubusercontent.com/nnar1o/kg/master/install.sh | sh

You can also download a ready binary from GitHub Releases.

Connect kg-mcp to Your AI Client

Add kg-mcp as a local stdio MCP server.

Example config:

{
  "mcpServers": {
    "kg": {
      "command": "/absolute/path/to/kg-mcp"
    }
  }
}

After that:

1. restart your AI client,
2. confirm the kg MCP server is available,
3. start using the prompts below.

Full MCP setup and reference: docs/mcp.md

SCL quickstart

kg understands short, verb-first English commands (SCL — Simple Command Language). The active graph is resolved from your config automatically.

find "compressor defrost"
get concept:refrigerator
add concept:smart_fridge --name "Smart Fridge" --description "Connected refrigerator"
modify concept:smart_fridge --importance 0.9
remove concept:old_idea
connect process:compressor_control TRIGGERS process:auto_defrost
disconnect process:compressor_control TRIGGERS process:auto_defrost
list nodes
stats
use fridge
help

Core verbs

IDs

Format: :snakecase — e.g. concept:fridge, bug:doorseal, process:compressor_cycle.

Relations

HAS USES STOREDIN TRIGGERS CREATEDBY AFFECTEDBY AVAILABLEIN DOCUMENTEDIN DEPENDSON TRANSITIONS DECIDEDBY GOVERNEDBY READS_FROM

Tips

Shortened. The full README is on GitHub.