Memorix (MCP server) — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Cross-Agent: funktioniert mit Claude Code, Cursor, Codex, Windsurf, Gemini CLI, OpenCode, Antigravity, Trae
Append-only mit Revisionshistorie
Tag-basierter Abruf (Projekt, Sprache, Entscheidung)
Lokales SQLite-Backend; optionale Cloud-Synchronisierung
Minimal — einzelne Node-Binary
MIT

Live-Demo

In der Praxis

memorix-mcp.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memorix-mcp",
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "memorix-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "memorix"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add memorix-mcp -- npx -y memorix

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Memorix

Projektkonventionen über alle Coding-Agenten teilen, ohne sie neu zu schreiben

👤 Entwickler, die mehrere AI-Coding-Tools gleichzeitig nutzen ⏱ ~15 min beginner

Wann einsetzen: Du erklärst am ersten Tag Cursor, Claude Code und Codex dasselbe Monorepo-Layout und vergisst, welcher davon was weiß.

Voraussetzungen

Memorix laufend — npx memorix — verwendet standardmäßig ~/.memorix.db

Ablauf

Erinnerungen anlegen

Save these facts about my project: package manager pnpm, runtime node 22, db postgres 16, auth in /apps/api/src/auth (not /legacy/auth).✓ Kopiert

→ 5 Erinnerungen mit Tags hinzugefügt
In einem anderen Agenten abrufen

(in Cursor mit demselben Memorix) — What conventions are set for this project?✓ Kopiert

→ Gibt dieselben 5 Erinnerungen zurück
Eine aktualisieren

Update memory: now using node 24 (was 22). Keep history.✓ Kopiert

→ Aktualisiert; Historie als Revision erhalten

Ergebnis: Projektkontext bleibt über Agenten und Tage hinweg erhalten.

Fallstricke

Erinnerungen werden veraltet — decay nutzen, um alte Erinnerungen mit niedrigem Vertrauen zu markieren; Agenten gewichten entsprechend

Architekturentscheidungen als abfragbare Erinnerungen festhalten

👤 Tech Leads, Staff Engineers ⏱ ~20 min intermediate

Wann einsetzen: Du triffst eine Entscheidung (‚wir nutzen nicht Redux, nur Zustand') und möchtest, dass sie Bestand hat.

Ablauf

Entscheidung dokumentieren

Save decision: 'Use zustand, not Redux. Reason: simpler API, smaller bundle.' Tag: state-management.✓ Kopiert

→ Entscheidung mit Tag gespeichert
Durchsetzung verifizieren

Whenever Claude is about to import redux in this repo, reject and quote the decision.✓ Kopiert

→ Nachfolgende Imports werden mit dem gespeicherten Grund markiert

Ergebnis: Ein ADR-ähnliches Log, das Agenten tatsächlich lesen.

Fallstricke

Memorix ist pro-Benutzer; teamweite ADRs benötigen Cloud-Sync oder eine eingecheckte Kopie — --export ./adr.json nutzen und committen; Teammates importieren mit --import

Kombinieren mit: github

Eine Debug-Session an einen anderen Agenten übergeben

👤 Entwickler, die mitten in einer Aufgabe zwischen Modellen wechseln ⏱ ~10 min intermediate

Wann einsetzen: Claude debuggt seit 2 Stunden und du möchtest zu Codex wechseln, ohne alles neu erklären zu müssen.

Ablauf

Snapshot erstellen

Snapshot current debugging context: hypothesis, what we ruled out, next step.✓ Kopiert

→ Snapshot mit Tag debug-session-<id> gespeichert
An anderer Stelle aufnehmen

(in Codex) — Load debug session and continue from where Claude left off.✓ Kopiert

→ Codex fasst den Snapshot zusammen und schlägt den nächsten Schritt vor

Ergebnis: Reibungsloser Agentenwechsel mitten in einer Aufgabe.

Fallstricke

Snapshot ist zu vage; neuer Agent beginnt von vorne — Memorixs Snapshot-Tool fragt nach: Hypothese, Belege, nächster Schritt — alle drei ausfüllen

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

memorix-mcp + github

Erinnerungen in eine eingecheckte adr.json-Datei für die Team-Weitergabe spiegeln

memorix-mcp + filesystem

Die lokale Memorix-DB sichern

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
save	content: str, tags: str[]	Eine Tatsache, Entscheidung oder einen Snapshot persistieren	kostenlos
recall	query?, tags?, limit?	Relevanten Kontext in die aktuelle Aufgabe bringen	kostenlos
update	id, content	Eine vorhandene Erinnerung korrigieren oder verfeinern	kostenlos
decay	older_than_days	Regelmäßige Bereinigung	kostenlos

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Lokales SQLite — durch Festplatte begrenzt
Tokens pro Aufruf: 100–500 pro Abruf
Kosten in €: Kostenlos; Cloud-Sync (falls genutzt) variiert
Tipp: Decay wöchentlich ausführen, damit Abrufabfragen aktuellen, präzisen Kontext liefern, keine 6 Monate alten Debug-Notizen

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Standardmäßig lokales SQLite; Cloud-Sync benötigt API-Key

Datenabfluss: Standardmäßig nur lokal

Erinnerungen können Secrets enthalten (z. B. ‚wir verwenden API-Key XYZ') — vor dem Exportieren / Committen prüfen

Fehlerbehebung

Häufige Fehler und Lösungen

Abruf gibt keine relevanten Ergebnisse zurück

Tags prüfen — Memorix nutzt Tag-Filter UND Fuzzy-Text

Prüfen: Ohne Filter ausführen, um alle Erinnerungen zu sehen

DB-Locked-Fehler

Mehrere Agenten schreiben gleichzeitig — Memorix nutzt WAL; sicherstellen, dass Version >= 0.4 vorliegt

Import schlägt fehl

Schema-Mismatch zwischen Export- und Import-Version — beide zuerst aktualisieren

Alternativen

Memorix vs. andere

Alternative	Wann stattdessen	Kompromiss
doobidoo/mcp-memory-service	Du möchtest reichhaltigere Funktionen wie Knowledge-Graph und Konsolidierung	Schwerer; Memorix ist bewusst minimal
OpenAI Memory / Anthropic Memory	Du nutzt nur einen Provider	An diesen Provider gebunden; Memorix ist Cross-Agent

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen