Skip to content

Krusch Context MCP

Persistent working memory and invariant steering MCP server for AI coding agents (Claude Code, Cursor, Windsurf). Captures architectural decisions, enforces project rules with…

Install

One-click install

Runs locally
Claude Code (no install link, copy and run)
$claude mcp add krusch-context -- npx -y krusch-context-mcp

Buttons open the app on your computer and ask you to confirm before anything is added.

$claude mcp add krusch-context -- npx -y krusch-context-mcp
mcp.json (Cursor, Claude Desktop, Windsurf)
{
  "mcpServers": {
    "krusch-context": {
      "command": "npx",
      "args": [
        "-y",
        "krusch-context-mcp"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

Krusch Context MCP

Local MCP server: five tools to store, retrieve, and retire project decisions. SQLite by default.

📖 Read the Systems Deep Dive: Check out the published architecture essay Beyond Flat Vector RAG: What Makes krusch-context-mcp Special on krusch.dev, or the local companion guide in docs/WHAT_MAKES_IT_SPECIAL.md.

Krusch Context MCP gives AI coding agents (Cursor, Claude Code, Windsurf, Antigravity) persistent working memory across sessions. It captures architectural decisions, invariants, lessons, and bug diagnoses, warns on near-duplicate memories, maintains temporal lineage when facts are superseded or invalidated, and audits diffs against active constraints.


🚫 What This Is Not

  • Not a codebase AST or Git indexer: Code symbol search, call graphs, and Git DAG traversal belong in krusch-git or your IDE's native search.
  • Not a 61-tool cafeteria: Collapsed to strictly 5 canonical verbs (~350 prompt tokens) for boring reliability.
  • Not a cloud SaaS platform: Runs 100% locally on your machine with zero external cloud dependencies.
  • Not a monolithic domain suite: Legal compliance (krusch-law), document ingestion (krusch-nexus), and contract graphs (krusch-biz) live in separate companion repositories.

⚡ 30-Second Quickstart

Requires Node.js >= 22.0.0. Run once inside your project repository:

npx krusch-context-mcp init

This command will:

  1. Validate Node >= 22.0.0 and initialize .agent/context.db via node:sqlite.
  2. Clear stale MCP tool schemas from local IDE caches.
  3. Create your project .env with sensible defaults.
  4. Seed initial project context and run a diagnostic health check.
  5. Print copy-paste JSON configurations for Cursor, Claude Code, and Claude Desktop.

🛠️ The 5-Verb Agent Loop

Krusch Context MCP exposes strictly 5 canonical verbs designed to fit into standard coding workflows:

Verb Short Alias Purpose
krusch_context_retrieve retrieve Pulls active memories, steering rules, and project state briefings within a strict limit_tokens budget. Returns citations.
krusch_context_remember remember Writes episodic facts and steering nuggets. Detects near-duplicates (similarity >= 0.85) and proposes revise(action: 'supersede') without blocking contrasting rules.
krusch_context_revise revise Updates stale knowledge (supersede with lineage tracking) or revokes obsolete rules (invalidate with mandatory reason).
krusch_context_nudge nudge Pre-commit auditor that checks proposed diffs against active project invariants (max 1–3 findings). Trigger defaults to pre_commit or manual; rejects every_turn.
krusch_context_health health Reports storage mode, memory counts by closed taxonomy, and 30-day TTL decay review.

🤖 Recommended Agent Protocol

Coding agents should interact with memory at specific lifecycle boundaries:

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

MCP serverDatabases+13 this week

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

Explore related