⚡ lithium-kb: Structured Agent Knowledge Base & Neural Graph

A high-performance structured project knowledge base generator, neural network memory visualizer, and Model Context Protocol (MCP) server for AI coding agents (Pi, Claude, Codex, Cursor, Windsurf).

📁 Structured Knowledge Hierarchy

Whenever lithium-kb is run, it organizes project memory into dedicated, modular knowledge categories:

your-project/
├── .agent-kb/
│   ├── architecture/
│   │   └── 1.overview.md          # Topology, entry points, service boundaries
│   ├── debug/
│   │   ├── 1.debug-quickstart.md  # Resolved incidents & root-cause postmortems
│   │   └── ...
│   ├── tasks/
│   │   ├── 1.task-initial-setup.md # Active sprint tasks & acceptance criteria
│   │   └── ...
│   └── features/
│       ├── 1.feature-spec.md      # Detailed feature specifications
│       └── ...
└── PROJECT_KB.md                  # Compact global index (< 2KB)

Related MCP server: AIVectorMemory

⚡ Why Structured Knowledge Matters

1. Surgical Token Efficiency: When an agent works on a bug or task, it reads only .agent-kb/tasks/N.<name>.md or .agent-kb/debug/N.<name>.md instead of blindly traversing thousands of codebase lines.

2. Deterministic Context: Agents don't lose track of multi-step plans across sessions.

3. Interactive Neural Visualizer: Observe live memory hits, dynamic impulse animations, and token savings as agents query knowledge nodes.

4. Zero Dependencies: Pure Node.js standard library — zero install footprint, lightning fast.

📦 Installation & Quickstart

🚀 1-Command Setup (Auto-Configure All Agents & Editors)

Run this inside any project repository to initialize the knowledge structure and automatically configure MCP for Cursor, Claude Desktop, Windsurf, Zed, and VS Code (Cline / Roo Code):

npx @liulinnuha/lithium-kb init

Additional Commands

# Generate / Sync knowledge base (.agent-kb/ and PROJECT_KB.md)
npx @liulinnuha/lithium-kb

# Open Neural Graph Web UI (port 3030)
npx @liulinnuha/lithium-kb --ui

# Auto-watch for file changes and sync live
npx @liulinnuha/lithium-kb --watch

# Launch MCP stdio server manually
npx @liulinnuha/lithium-kb --mcp

Method 2: Global CLI Installation

Install globally on your machine to use lithium-kb anywhere:

npm install -g @liulinnuha/lithium-kb

# Then run anywhere:
lithium-kb --ui

🔌 Agent MCP Integration (Claude Desktop, Cursor, Pi)

Add this to your Claude Desktop config (claude_desktop_config.json) or Cursor MCP settings:

{
  "mcpServers": {
    "lithium-kb": {
      "command": "npx",
      "args": ["-y", "@liulinnuha/lithium-kb", "--mcp"]
    }
  }
}

📜 MCP Tools Exposed

📄 License

MIT © Moch Ulin Nuha