Knowledge Keeper MCP

🧠 Give your AI agent long-term memory — 32 MCP tools, zero API keys, zero infrastructure, works with Claude Code, Cursor, Gemini CLI, Windsurf, hermes-agent

v1.7.1 — npm | GitHub | Quick Start | Landing Page | Blog

Why? Your AI coding agent forgets everything between sessions. Knowledge Keeper gives it persistent, searchable, connected memory — all stored locally with zero cloud dependency.

✨ Features

• ✅ 32 MCP Tools — Complete knowledge management toolkit
• ✅ Hybrid Search — BM25 (R@5=95%) + TF-IDF semantic + RRF fusion
• ✅ Knowledge Graph — Entity detection, relationships, Mermaid visualization
• ✅ Analytics — Overview, quality insights, timeline
• ✅ Version History — Diff & rollback any change
• ✅ Obsidian Compatible — Read/write with Obsidian vault
• ✅ Audit Trail — SHA256 hash chain, integrity verification
• ✅ Duplicate Detection — Find and merge similar knowledge points
• ✅ Context Explorer — One-call knowledge neighborhood (links + tags + similar)
• ✅ Spaced Repetition — Never forget what you've learned
• ✅ Cloud Sync (Pro) — End-to-end encrypted, multi-device
• ✅ Local-First — All data on your machine, private by default
• ✅ Zero AI Dependency — No API keys needed. No OpenAI. No embeddings API.
• ✅ MIT Licensed — Free for commercial use
• ✅ 70 Tests Passing — Reliable and tested
• ✅ Optimized Performance — Direct index reads for 2-5x faster analytics/export/sync

Why Knowledge Keeper?

Key insight: Knowledge Keeper is the only option that works with zero API keys, stores everything as human-readable Markdown, and includes audit + version history — making it ideal for developers who value transparency and simplicity.

Install

npm install @zsc-glitch/knowledge-keeper-mcp

Quick Start

Claude Code

claude mcp add knowledge-keeper -- npx @zsc-glitch/knowledge-keeper-mcp

Cursor / Windsurf / Gemini CLI

Add to your MCP config:

{
  "mcpServers": {
    "knowledge-keeper": {
      "command": "npx",
      "args": ["@zsc-glitch/knowledge-keeper-mcp"]
    }
  }
}

hermes-agent

Add to your hermes MCP config.

MCP Tools (30)

CRUD

Search

Knowledge Graph

Organization

Quality

Analytics

Data

Cloud Sync (Pro)

MCP Resources (7)

Obsidian Vault Compatible ✅

All knowledge entries are standard Markdown files with frontmatter:

---
id: concept_abc123
type: concept
tags: [ai, memory, mcp]
aliases: [Knowledge Management]
created: 2026-04-28
updated: 2026-04-28
---

# My Knowledge Entry

Content here...

## Related
- [[other-entry-id]]

Open your vault in Obsidian: obsidian ~/.knowledge-vault/

Search Benchmarks

Achieves competitive recall without any embedding API.

Cloud Sync (Pro)

End-to-end encrypted sync across devices:

# Set environment variables
export KK_SYNC_URL=https://your-sync-server.com
export KK_API_KEY=kk_your_api_key
export KK_ENCRYPTION_KEY=your-passphrase

Server cannot decrypt your data — all encryption happens client-side.

Data Storage

• Default: ~/.knowledge-vault/
• Entries: ~/.knowledge-vault/{type}/{id}.md (Obsidian compatible)
• Index: ~/.knowledge-vault/index.json
• BM25: ~/.knowledge-vault/bm25-index.json
• Custom path: Set KK_VAULT_PATH environment variable

Upgrade Embedding Model

Default: TF-IDF (zero dependency).

# Upgrade to Transformer model
npm install @xenova/transformers
EMBEDDING_MODEL=transformers npx @zsc-glitch/knowledge-keeper-mcp

Development

npm run build    # Compile TypeScript
npm test         # Run 70 tests
node dist/index.js  # Start server

Version History

License

MIT — Free for commercial use.

☕ Support the Developer

If this tool helps you, consider buying me a coffee ☕

Made with 🧠 by 小影