Krusch Context MCP
Local MCP server giving AI coding agents persistent working memory for project decisions across sessions.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Node.js >= 22.0.0
install krusch-context-mcp globally via npm
npm install -g krusch-context-mcp
Where the README and reality differ
- README: Zero-GPU default runs 100% offline using deterministic keyword extraction if neither Ollama nor API key is present
What worked: krusch_context_remember fails with "MCP error -32603: Failed to generate embedding" unless OLLAMA_URL/OPENROUTER_API_KEY or EMBEDDING_URL is reachable; verified via direct MCP call after init and after switching .env to EMBEDDING_PROVIDER=auto - README: npx krusch-context-mcp init creates .env with sensible defaults for offline use
What worked: init writes OLLAMA_BASE_URL=http://localhost:11434 EMBEDDING_PROVIDER=ollama which makes remember fail without a running Ollama instance
Add it to your agent
claude mcp add krusch-context-mcp -- krusch-context-mcpJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"krusch-context-mcp": {
"command": "krusch-context-mcp",
"args": []
}
}
}Add the krusch-context-mcp server to your MCP client's configuration, then ask your agent to call krusch_context_health to confirm it is connected.
What it does
- Store, retrieve, and retire project decisionsNot tested
- Record architectural decisions and lessonsNot tested
- Check diffs against active project invariantsNot tested
- Replace outdated facts and keep their historyNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 0 of 4 features work
- Works offline
Good for
- capture architectural decisions and invariants
- retrieve active memories and steering rules
- audit diffs against project invariants pre-commit
- supersede stale knowledge with lineage tracking
- report memory health and TTL decay review
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
- Version 1.8.0
An MCP client handshake over stdio listed 5 tools, and a call to krusch_context_health returned a result.
Differences the test machine hit
- README: krusch-context-mcp --help / --version
In the test: binary has no --help/--version flag; running without args starts MCP stdio server (ExperimentalWarning: SQLite)