🧠 Prism MCP — Der Gedächtnispalast für KI-Agenten

Dein KI-Agent vergisst alles zwischen den Sitzungen. Prism behebt das — und bringt ihm das Denken bei.

Prism v7.8 ist eine echte kognitive Architektur, inspiriert von der Mechanik des menschlichen Gehirns. Über die einfache Vektorsuche hinaus bildet dein Agent nun Prinzipien aus Erfahrungen, folgt kausalen Gedankengängen und besitzt die Selbstwahrnehmung, zu wissen, wann ihm Informationen fehlen. Deine Agenten erinnern sich nicht nur; sie lernen.

npx -y prism-mcp-server

Funktioniert mit Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Gemini · Antigravity — jedem MCP-Client.

https://github.com/dcostenco/prism-mcp/raw/main/docs/prism_mcp_demo.mp4

📖 Inhaltsverzeichnis

• Warum Prism?

• Schnellstart

• Der magische Moment

• Einrichtungsanleitungen

• Universeller Import: Übernimm deine Historie

• Was Prism anders macht

• Kognitive Architektur (v7.8)

• Datenschutz & Datenausgang

• Anwendungsfälle

• Was ist neu

• Wie Prism im Vergleich abschneidet

• CLI-Referenz

• Tool-Referenz

• Umgebungsvariablen

• Architektur

• Wissenschaftliche Grundlage

• Meilensteine & Roadmap

• Fehlerbehebung FAQ

Warum Prism?

Jedes Mal, wenn du ein neues Gespräch mit einem KI-Programmierassistenten beginnst, fängt er bei Null an. Du erklärst deine Architektur erneut, beschreibst deine Entscheidungen neu, listest deine TODOs wieder auf. Stundenlanger Kontext — weg.

Prism gibt deinem Agenten ein Gehirn, das bestehen bleibt — und bringt ihm dann das Schlussfolgern bei. Speichere am Ende jeder Sitzung, was wichtig ist. Lade es in der nächsten sofort wieder. Aber Prism geht weit über die Speicherung hinaus: Es konsolidiert rohe Erfahrungen zu dauerhaften Prinzipien, durchläuft Kausalketten, um Grundursachen aufzudecken, und weiß, wann es sagen muss: "Ich weiß es nicht."

📌 Terminologie: In diesem Dokument bezieht sich "Prism" auf den MCP-Server und die kognitive Gedächtnis-Engine. "Mind Palace" bezieht sich auf das visuelle Dashboard-UI unter localhost:3000 — dein Fenster in das Gehirn des Agenten. Sie arbeiten zusammen; das Dashboard ist optional.

Prism hat drei Säulen:

1. 🧠 Kognitives Gedächtnis — Erinnerungen werden wie in einem menschlichen Gehirn gewichtet: Kürzlich und häufig abgerufener Kontext erscheint zuerst, während veralteter Kontext natürlich durch ACT-R-Aktivierungszerfall verblasst. Rohe Erfahrungen konsolidieren sich durch Hebb-Lernen zu semantischen Prinzipien. Das Ergebnis ist eine Abrufqualität, die keine einfache Vektorsuche erreichen kann. (Siehe Kognitive Architektur und Wissenschaftliche Grundlage.)

2. 🔗 Multi-Hop-Schlussfolgerung — Wenn dein Agent nach "Fehler X" sucht, findet Prism nicht nur Protokolle, die "Fehler X" erwähnen. Die Ausbreitungsaktivierung durchläuft den Kausalgraphen und bringt "Workaround Y" zurück, das mit "Architekturentscheidung Z" verbunden ist — ein buchstäblicher Gedankengang. (Siehe Kognitive Architektur.)

3. 🏭 Autonome Ausführung (Dark Factory) — Wenn du bereit bist, kann Prism Programmieraufgaben von Anfang bis Ende mit einer Fail-Closed-Pipeline ausführen, bei der ein gegnerischer Evaluator Fehler findet, die der Generator übersehen hat — bevor du den PR überhaupt siehst. (Siehe Dark Factory.)

🚀 Schnellstart

Voraussetzungen

• Node.js v18+ (v20 LTS empfohlen; v23.x hat bekannte npx-Eigenheiten)

• Jeder MCP-kompatible Client (Claude Desktop, Cursor, Windsurf, Cline, etc.)

• Keine API-Schlüssel für Kernfunktionen erforderlich (siehe Fähigkeitsmatrix)

Installation

Füge dies zu deiner MCP-Client-Konfiguration hinzu (claude_desktop_config.json, .cursor/mcp.json, etc.):

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"]
    }
  }
}

⚠️ Windows / Eingeschränkte Shells: Wenn dein MCP-Client sich beschwert, dass npx nicht gefunden wurde, verwende den absoluten Pfad zu deiner Node-Binary (z. B. C:\Program Files\nodejs\npx.cmd).

Das war's. Starte deinen Client neu. Alle Tools sind verfügbar. Das Mind Palace Dashboard (das visuelle UI für das Gehirn deines Agenten) startet automatisch unter http://localhost:3000. Du musst keinen Tab offen halten — das Dashboard läuft im Hintergrund und die MCP-Tools funktionieren mit oder ohne es.

🔮 Profi-Tipp: Öffne nach der Installation http://localhost:3000 in deinem Browser, um das Mind Palace Dashboard zu sehen — ein wunderschönes Echtzeit-UI des Gehirns deines Agenten. Erkunde den Wissensgraphen, die Intent-Health-Anzeigen und das Sitzungsbuch.

🔄 Prism aktualisieren: npx -y speichert das Paket lokal zwischen. Um ein Update auf die neueste Version zu erzwingen, starte deinen MCP-Client neu — npx -y holt automatisch die neueste Version. Wenn du auf einer veralteten Version feststeckst, führe npx clear-npx-cache (oder npm cache clean --force) vor dem Neustart aus.

Füge PRISM_DASHBOARD_PORT zum Env-Block deiner MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": { "PRISM_DASHBOARD_PORT": "3001" }
    }
  }
}

Öffne dann stattdessen http://localhost:3001.

Fähigkeitsmatrix

🔑 Der Kern des Mind Palace funktioniert zu 100 % offline ohne API-Schlüssel. Cloud-Schlüssel schalten Intelligenzfunktionen frei. Siehe Umgebungsvariablen.

💰 Hinweis zu API-Kosten: GOOGLE_API_KEY (Gemini) hat ein großzügiges kostenloses Kontingent, das die meisten individuellen Nutzungen abdeckt. BRAVE_API_KEY bietet 2.000 kostenlose Suchen/Monat. FIRECRAWL_API_KEY hat einen kostenlosen Plan mit 500 Credits. Für typische Solo-Entwicklung sind 0 $/Monat in den kostenlosen Stufen zu erwarten. Nur Teams mit hohem Volumen oder intensiver Nutzung autonomer Pipelines verursachen nennenswerte Kosten.

✨ Der magische Moment

Sitzung 1 (Montagabend):

You: "Analyze this auth architecture and plan the OAuth migration."
Agent: *deep analysis, decisions, TODO list*
Agent: session_save_ledger → session_save_handoff ✅

Sitzung 2 (Dienstagmorgen — neues Gespräch, neues Kontextfenster):

Agent: session_load_context → "Welcome back! Yesterday we decided to use PKCE
       flow with refresh tokens. 3 TODOs remain: migrate the user table,
       update the middleware, and write integration tests."
You: "Pick up where we left off."

Dein Agent erinnert sich an alles. Kein erneutes Hochladen von Dateien. Kein erneutes Erklären von Entscheidungen.

📖 Einrichtungsanleitungen

Füge dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"]
    }
  }
}

Füge dies zu .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global) hinzu:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"]
    }
  }
}

Füge dies zu ~/.codeium/windsurf/mcp_config.json hinzu:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"]
    }
  }
}

Füge dies zu deiner Continue config.json oder den Cline MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": {
        "PRISM_STORAGE": "local",
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Claude Code erkennt MCP-Tools automatisch, wenn sie zu deinen Workspace .clauderules hinzugefügt werden. Füge einfach hinzu:

Always start the conversation by calling `mcp__prism-mcp__session_load_context(project='my-project', level='deep')`.
When wrapping up, always call `mcp__prism-mcp__session_save_ledger` and `mcp__prism-mcp__session_save_handoff`.

Format-Hinweis: Claude umschließt MCP-Tools automatisch mit doppelten Unterstrichen (mcp__prism-mcp__...), während die meisten anderen Clients einfache Unterstriche verwenden (mcp_prism-mcp_...). Das Backend von Prism verarbeitet beide Formate nativ und nahtlos.

CLI-Alternative: Wenn MCP-Tools nicht verfügbar sind oder du Skripte um Claude Code herum schreibst:

# Load context before a session
prism load my-project --level deep

# Machine-readable JSON for parsing in scripts
prism load my-project --level deep --json

Siehe den Gemini-Einrichtungsleitfaden für die bewährte Drei-Schichten-Prompt-Architektur, um ein zuverlässiges automatisches Laden der Sitzung zu gewährleisten.

Antigravity stellt dem Modell keine MCP-Tools zur Verfügung. Verwende die prism load CLI als Fallback:

# From a shell or run_command tool
prism load my-project --level standard --json

# Or via the wrapper script
bash ~/.gemini/antigravity/scratch/prism_session_loader.sh my-project

Die CLI verwendet dieselbe Speicherschicht wie das MCP-Tool (SQLite oder Supabase).

⚠️ KRITISCH (v9.2.2): Vermeidung von Split-Brain Wenn dein MCP-Server mit PRISM_STORAGE=local konfiguriert ist, aber auch Supabase-Anmeldedaten gesetzt sind, liest die CLI möglicherweise vom falschen Backend (Supabase), während der Server in SQLite schreibt. Dies führt zu veralteten TODOs und abweichendem Status. Übergebe immer explizit --storage local, wenn du die CLI in einer lokalen Umgebung verwendest:

prism load my-project --storage local --json

Der prism_session_loader.sh-Wrapper handhabt dies seit v9.2.2 automatisch.

Verwende die prism load CLI, um aus jeder Shell-Umgebung auf den Sitzungskontext zuzugreifen:

# Quick check — human-readable
prism load my-project

# Parse JSON in scripts
CONTEXT=$(prism load my-project --level quick --json)
SUMMARY=$(echo "$CONTEXT" | jq -r '.handoff[0].last_summary')
VERSION=$(echo "$CONTEXT" | jq -r '.handoff[0].version')
echo "Project at v$VERSION: $SUMMARY"

# Explicit storage backend (v9.2.2 — prevents split-brain)
prism load my-project --storage local --json
prism load my-project --storage supabase --json

# Role-scoped loading
prism load my-project --role qa --json

# Use in CI/CD to verify context exists before deploying
if ! prism load my-project --level quick --json | jq -e '.handoff[0].version' > /dev/null 2>&1; then
  echo "No Prism context found — skipping context-aware deploy"
fi

📦 Installation: npm install -g prism-mcp-server macht die prism CLI global verfügbar. Für lokale Builds: node /path/to/prism/dist/cli.js load.

Um das Gedächtnis über Maschinen oder Teams hinweg zu synchronisieren:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": {
        "PRISM_STORAGE": "supabase",
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_KEY": "your-supabase-anon-or-service-key"
      }
    }
  }
}

Schema-Migrationen

Prism wendet sein Schema beim ersten Verbinden automatisch an — kein manueller Schritt erforderlich. Wenn du Migrationen manuell anwenden oder erneut anwenden musst (z. B. für ein neues Projekt oder nach einem Versionssprung), führe die SQL-Dateien in supabase/migrations/ in nummerierter Reihenfolge über den Supabase SQL Editor oder die CLI aus:

# Via CLI (requires supabase CLI + project linked)
supabase db push

# Or apply a single migration via the Supabase dashboard SQL Editor
# Paste the contents of supabase/migrations/0NN_*.sql and click Run

Wichtige Migrationen:

• 020_* — Kernschema (Ledger, Handoff, FTS, TTL, CRDT)

• 033_memory_links.sql — Assoziativer Wissensgraph (MemoryLinks) — erforderlich für session_backfill_links

Anon-Schlüssel vs. Service-Role-Schlüssel: Der Anon-Schlüssel funktioniert für den persönlichen Gebrauch (Supabase RLS-Richtlinien gelten). Verwende den Service-Role-Schlüssel für Team-Bereitstellungen, bei denen mehrere Benutzer dasselbe Supabase-Projekt teilen — er umgeht RLS und ermöglicht es Prism, alle Zeilen unabhängig vom Auth-Kontext zu verwalten. Gib den Service-Role-Schlüssel niemals clientseitig preis.

git clone https://github.com/dcostenco/prism-mcp.git
cd prism-mcp && npm install && npm run build

Füge dies dann zu deiner MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "prism-mcp": {
      "command": "node",
      "args": ["/path/to/prism-mcp/dist/server.js"],
      "env": {
        "BRAVE_API_KEY": "your-key",
        "GOOGLE_API_KEY": "your-gemini-key"
      }
    }
  }
}