whimsicality-mcp

Ein MCP (Model Context Protocol)-Server, der KI-Agenten persistenten Speicher bietet — Kontextspeicherung, Fakten, Pläne, RAG-Suche, Code-Snippets und Gesprächskompression, die über Sitzungen und Prozesse hinweg erhalten bleiben.

Funktioniert mit jedem MCP-kompatiblen Agenten: Devin CLI, Claude Desktop, Cursor und anderen.

Schnellstart

# Install globally
npm install -g whimsicality-mcp

# Or run without installing
npx whimsicality-mcp

Fügen Sie es dann zur MCP-Konfiguration Ihres Agenten hinzu:

{
  "mcpServers": {
    "whimsicality": {
      "command": "npx",
      "args": ["whimsicality-mcp"]
    }
  }
}

Das war's. Der Server funktioniert sofort mit diskbasierter Persistenz — keine nativen Abhängigkeiten erforderlich. Daten werden in ~/.whimsicality/kernel-storage/ gespeichert.

Related MCP server: Memory MCP

Werkzeuge

Der Server stellt 14 Werkzeuge bereit, alle mit dem Präfix whim_:

Wie Agenten es verwenden sollten

Zu Beginn der Sitzung — Zustand von früheren Agenten wiederherstellen:

1. whim_plan_get({})              → read the current plan
2. whim_facts_list({})            → list all facts
3. whim_facts_get({name: "..."})  → read relevant facts
4. whim_context_list({})          → list all context slots
5. whim_context_get({key: "..."}) → read relevant slots

Während der Arbeit — Zustand für den nächsten Agenten speichern:

whim_plan_save({plan: "updated plan with progress and next steps"})
whim_facts_save({name: "new_fact", value: "..."})
whim_context_set({key: "what_i_learned", text: "..."})

Backends

Der Server unterstützt vier Möglichkeiten, den Kernel zu finden, die in dieser Reihenfolge ausprobiert werden:

1. Disk-Fallback (Standard, keine Einrichtung)

Funktioniert sofort. Daten werden in einer JSON-Datei unter ~/.whimsicality/kernel-storage/whim-mcp-store.json gespeichert. Wortüberlappungssuche für RAG/Snippets. Keine nativen Abhängigkeiten.

2. Vorgefertigtes Kernel-Binary (einfachstes Upgrade)

npm install @whimsicalitylabs/kernel-prebuilt

Plattformspezifische vorgefertigte Binaries werden über npm optionalDependencies verteilt. Der Server findet das Binary automatisch in node_modules.

Hinweis: Vorgefertigte Binaries sind noch nicht für alle Plattformen verfügbar. Siehe kernel-prebuilt für den Status.

3. Auf ein vorhandenes Binary zeigen

{
  "mcpServers": {
    "whimsicality": {
      "command": "npx",
      "args": ["whimsicality-mcp"],
      "env": {
        "WHIMSICALITY_KERNEL_BIN": "/path/to/whimsicality-kernel"
      }
    }
  }
}

4. Aus dem Quellcode bauen

Klonen Sie den Rust-Workspace und bauen Sie:

git clone https://github.com/WhimsicalityLabs/whimsicality-kernel.git
cd whimsicality-kernel
cargo build --release

Setzen Sie dann WHIMSICALITY_KERNEL_BIN auf target/release/whimsicality-kernel.

Was der Kernel hinzufügt

Der Rust-Kernel bietet:

• Abgestufter Speicher: heiß (RAM) → warm (mmap) → kalt (zstd auf Disk) mit automatischer Promotion/Demotion

• Inhaltsadressierte Deduplizierung: identische Werte teilen Speicher über blake3-Hashing

• Lock-freier Hot Path: DashMap für gleichzeitige Lesezugriffe

• Nur-Anhängen-Sitzungsprotokoll: bincode-Einträge mit Verzweigung/Forking

• Strukturierte Kontextzusammenstellung: benannte Variablen, keine flachen Token-Streams

Wenn der Kernel verfügbar ist, schreibt der Server doppelt in den Kernel und auf die Disk. Dies bietet den schnellen In-Sitzungs-Zugriff des Kernels plus Disk-Persistenz für zuverlässige sitzungsübergreifende Nutzung (die heiße Ebene des Kernels ist nur RAM und geht beim Prozessende verloren).

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen:

Entwicklung

git clone https://github.com/WhimsicalityLabs/Whimsicality-MCP.git
cd whimsicality-mcp
npm install
npm run build
node bin/whimsicality-mcp.js

Lizenz

MIT