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?

	Knowledge Keeper	mempalace	memU	GitNexus
Zero API keys	✅ No cloud, no embeddings API	❌ ChromaDB	❌ OpenAI + LangChain	❌ LLM for Graph RAG
MCP Protocol	✅ Native	✅	❌ Custom	✅
Obsidian Compatible	✅ Read/write vault	❌	❌	❌
Audit Trail	✅ SHA256 hash chain	❌	❌	❌
Version History	✅ Diff & rollback	❌	❌	❌
Hybrid Search	✅ BM25 + TF-IDF + RRF	✅ Vector only	✅ Vector only	✅ Graph RAG
Spaced Repetition	✅	❌	❌	❌
Knowledge Graph	✅ Entity detection + Mermaid	✅	❌	✅ (code-focused)
Local-First	✅ Markdown files	✅	⚠️ Server needed	✅
License	MIT	MIT	MIT	Custom
Best for	General knowledge memory	Benchmark scores	24/7 proactive agents	Code architecture

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

Tool	Description
knowledge_save	Save knowledge entry
knowledge_get	Get by ID
knowledge_update	Update entry
knowledge_delete	Delete entry

Search

Tool	Description
knowledge_search	Basic keyword search
knowledge_semantic_search	TF-IDF semantic search
knowledge_bm25_search	BM25 keyword search (R@5=95%)
knowledge_hybrid_search	RRF fusion (BM25 + semantic, R@5=97%+)
knowledge_recent	Recently added/updated entries
knowledge_duplicates	Detect similar/duplicate knowledge points
knowledge_context	Knowledge neighborhood explorer (links, tags, similar titles)

Knowledge Graph

Tool	Description
knowledge_graph	Graph operations
knowledge_graph_build	Build graph (entity detection)
knowledge_graph_query	Query entities & relations
knowledge_graph_visualize	Mermaid visualization

Organization

Tool	Description
knowledge_tags	Tag management
knowledge_link	Link entries
knowledge_unlink	Remove link
knowledge_get_linked	Get linked entries

Quality

Tool	Description
knowledge_versions	Version history (diff & rollback)
knowledge_review	Spaced repetition review
knowledge_audit	SHA256 integrity check

Analytics

Tool	Description
knowledge_analytics_overview	Stats & health score
knowledge_analytics_insights	Orphans, duplicates, stale items
knowledge_analytics_timeline	Daily/weekly/monthly activity

Data

Tool	Description
knowledge_export	Export (JSON/Markdown/CSV)
knowledge_import	Import (JSON/Markdown)
knowledge_batch	Batch operations
knowledge_sync	Local vault sync
knowledge_merge	Merge vaults
knowledge_bm25_stats	BM25 index stats

Cloud Sync (Pro)

Tool	Description
knowledge_sync_status	Check sync status
knowledge_sync	Push/pull cloud sync (E2E encrypted)
knowledge_license	View license & features

MCP Resources (7)

Resource	URI	Description
All Knowledge	knowledge:///list	List all entries
Tags Index	knowledge:///tags	All tags with counts
Concepts	knowledge:///type/concept	Concept entries
Decisions	knowledge:///type/decision	Decision entries
Todos	knowledge:///type/todo	Todo entries
Notes	knowledge:///type/note	Note entries
Projects	knowledge:///type/project	Project entries

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

Method	Recall@5	AI Dependency
BM25 keyword	95%	None
Hybrid (BM25 + semantic + RRF)	97%+	None

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

Version	Highlights
1.7.0	Knowledge context explorer (1-call neighborhood), 32 tools
1.6.0	Duplicate detection + merge suggestions, 32 tools
1.5.0	Performance: 2-5x faster analytics/export/sync, knowledge_recent, batch update_type
1.4.7	knowledge_recent tool, 32 tools
1.4.5	serverInfo version fix
1.4.3	MCP Registry support (mcpName), Dockerfile for Glama
1.4.0	Hybrid search (RRF), BM25 R@5=95%, 32 tools
1.3.0	Real version history (list/get/diff/rollback)
1.2.0	Knowledge analytics (overview/insights/timeline)
1.1.0	Cloud sync (Pro), 26 tools
1.0.0	First stable release, 23 tools
0.7.0-alpha	Knowledge review (spaced repetition)
0.6.0-alpha	BM25 keyword search
0.5.0-alpha	Obsidian vault compatibility
0.4.0-alpha	Audit trail (SHA256)
0.3.0-alpha	MCP Resources
0.2.0-alpha	Semantic search (TF-IDF)
0.1.0-alpha	Initial 6 tools

License

MIT — Free for commercial use.

---

☕ Support the Developer

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

---

Made with 🧠 by 小影