Claude Memory MCP

Local-First-Speicherdatenbank und Kontinuitätsjournal für MCP-Clients.

claude-memory-mcp ist eine einfache lokale Speicherdatenbank und ein leichtgewichtiges Kontinuitätsjournal für KI-Workflows. Es hilft einem Agenten, die Arbeit kohärent wiederaufzunehmen, indem es kompakte Kontinuitätsartefakte speichert, wichtige Entscheidungen und Zustände nachverfolgt und nur den angeforderten Detailgrad zurückgibt, anstatt ein vollständiges Archiv in den Kontext zu laden.

Verwenden Sie es, wenn Sie einen lokalen, privaten Kontinuitätsspeicher wünschen, der über MCP-Clients und Shell-Skripte hinweg funktioniert. Es handelt sich um bewusst unspektakuläre Infrastruktur: SQLite auf Ihrem Rechner, ein MCP-Tool, ein CLI, expliziter Import/Export und kein gehosteter Dienst.

• Veröffentlichtes Paket: @whenmoon-afk/memory-mcp

• Unterstützter CLI-Befehl: claude-memory-mcp

• Speicherung: nur lokale SQLite

• Datenschutz: keine Telemetrie, keine Netzwerkaufrufe, kein Cloud-Dienst

Warum v3?

Die letzte npm-veröffentlichte v2-Version war 2.5.0. v3 ist ein bewusster Produkt-Neustart: Die ältere, identitätsorientierte Oberfläche mit self, reflect und anchor wurde entfernt, und das Projekt konzentriert sich nun auf einfache lokale Kontinuität.

Client-native Speicherfunktionen sind nützlich, wenn Ihr Client sie bereitstellt, aber sie gehören normalerweise dem Client. claude-memory-mcp ist für eine andere Aufgabe gedacht: ein portabler, überprüfbarer, lokaler, privater Kontinuitätsspeicher, den Sie sichern, importieren, skripten und schrittweise abfragen können.

Diese Version soll stabil und konservativ sein. Sie priorisiert klare Verträge, lokale Speicherung, vorhersehbares CLI/MCP-Verhalten und eine kleine öffentliche Oberfläche, die von nachgelagerten Forks verstanden werden kann.

Related MCP server: ClaudeKeep

Was dies nicht ist

• Es ist kein Cloud-Speicherdienst.

• Es ist kein Ersatz für nativen Client-Speicher.

• Es ist kein Transkript-Archiv.

• Es ist kein autonomer Hintergrund-Rekorder.

• Es ist kein Plugin oder Marketplace-Paket.

• Es ist kein Aufgaben-Tracker, Abhängigkeitsgraph oder Multi-Agenten-Koordinationssystem.

Was es bietet

• Ein MCP-Tool: continuity

• Ein gespiegeltes CLI für lokales Skripting und Inspektion

• Funktionale CLI-Befehle für doctor, export und import

• Dateibasierte Backups mit Import-Trockenlauf-Validierung

• Progressive Offenlegung standardmäßig: zuerst kompakte Listen, volle Details nur auf explizite Anfrage

• Fünf Artefakt-Typen:

  • snapshot

  • decision

  • project_state

  • bundle

  • meta_snapshot

• Verknüpfte Knotentypen:

  • project

  • theme

  • entity

MCP-Oberfläche

Der Server stellt ein einzelnes Tool im Dispatch-Stil bereit:

Beispiel-Tool-Aufrufe:

{"action":"save","type":"snapshot","title":"JWT auth pass","summary":"Middleware works and tests are green","project":"notes-api","themes":["authentication"],"entities":["jwt"],"next_steps":["Add password reset flow"]}
{"action":"search","query":"jwt auth"}
{"action":"get","id":"snap-1","detail":"compact"}
{"action":"node","id":"theme:authentication"}
{"action":"related","id":"snap-1","via":"all"}
{"action":"bundle","project":"notes-api"}

Beispiel-Workflow

Eine Projektentscheidung aufzeichnen:

npx @whenmoon-afk/memory-mcp save \
  --type decision \
  --title "Keep auth continuity local-first" \
  --summary "Use SQLite continuity artifacts instead of external sync for auth handoff." \
  --project notes-api \
  --theme authentication \
  --entity sqlite \
  --next "Document restore flow"

Kompakten Projektkontext auflisten:

npx @whenmoon-afk/memory-mcp list --project notes-api

Nahegelegenen Graph-Kontext inspizieren:

npx @whenmoon-afk/memory-mcp node theme:authentication
npx @whenmoon-afk/memory-mcp related dec-1 --via all

Ein Zusammenfassungs-Bundle erstellen:

npx @whenmoon-afk/memory-mcp bundle --project notes-api

Den Kontinuitätsspeicher sichern und validieren, bevor etwas ersetzt wird:

npx @whenmoon-afk/memory-mcp backup --file continuity-backup.json
npx @whenmoon-afk/memory-mcp import --file continuity-backup.json --dry-run

CLI

Verwenden Sie npx, ohne es global zu installieren:

npx @whenmoon-afk/memory-mcp setup
npx @whenmoon-afk/memory-mcp save --type snapshot --title "JWT auth pass" --summary "Middleware works" --project notes-api --theme authentication --entity jwt --next "Add password reset flow"
npx @whenmoon-afk/memory-mcp list --project notes-api
npx @whenmoon-afk/memory-mcp node theme:authentication
npx @whenmoon-afk/memory-mcp related snap-1 --via all
npx @whenmoon-afk/memory-mcp doctor
npx @whenmoon-afk/memory-mcp backup --file continuity-backup.json
npx @whenmoon-afk/memory-mcp export > continuity-export.json
npx @whenmoon-afk/memory-mcp import --file continuity-export.json --dry-run
npx @whenmoon-afk/memory-mcp import --file continuity-export.json
npx @whenmoon-afk/memory-mcp get snap-1 --full

Wenn Sie es global installieren, lautet die unterstützte Binärdatei claude-memory-mcp:

npm install -g @whenmoon-afk/memory-mcp
claude-memory-mcp serve
claude-memory-mcp search "password reset"
claude-memory-mcp bundle --project notes-api
claude-memory-mcp doctor

Node 20 oder neuer ist die unterstützte Laufzeitumgebung für das CLI und den MCP-Server.

Installation

Claude Code

claude mcp add continuity -- npx -y @whenmoon-afk/memory-mcp

Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "continuity": {
      "command": "npx",
      "args": ["-y", "@whenmoon-afk/memory-mcp"]
    }
  }
}

Andere MCP-Clients

Verwenden Sie denselben stdio-Befehl:

npx -y @whenmoon-afk/memory-mcp

Überprüfen Sie nach der Einrichtung, ob der Client continuity mit {"action":"list"} aufrufen kann.

Datenspeicherung

Alles bleibt lokal. Standardmäßig verwendet der Server eine SQLite-Datenbank:

Umgebungsvariablen:

• CLAUDE_MEMORY_DATA_DIR: überschreibt das Basisverzeichnis

• CLAUDE_MEMORY_DB_PATH: zeigt direkt auf eine Datenbankdatei

Wenn Sie eine repo-lokale Isolierung wünschen, lassen Sie CLAUDE_MEMORY_DB_PATH beim Starten des Servers oder CLI auf einen projektspezifischen Pfad zeigen.

Operative Befehle

Diese Befehle sind nur für das CLI gedacht und dienen eher der lokalen Wartung als dem Abruf durch den Agenten:

• claude-memory-mcp doctor: meldet Schema-Version, SQLite-Integrität und Zeilenanzahl

• claude-memory-mcp export: schreibt einen versionierten JSON-Export-Umschlag auf stdout

• claude-memory-mcp backup --file <path>: schreibt denselben Export-Umschlag in eine Datei

• claude-memory-mcp import --file <path> --dry-run: validiert einen Export-Umschlag, ohne den aktuellen Speicher zu ändern

• claude-memory-mcp import --file <path>: ersetzt den aktuellen Speicher durch einen zuvor exportierten JSON-Umschlag

Die ID des Export-Umschlagformats lautet claude-memory-continuity-export. Der stabile Vertrag für Artefakte, Graph-Knoten, operative Befehle und Schema-Versionierung ist in CONTRACT.md dokumentiert.

Release

Das npm-Paket ist @whenmoon-afk/memory-mcp; die v3 CLI-Binärdatei ist claude-memory-mcp. Release- und Veröffentlichungsschritte sind in RELEASE.md dokumentiert.

Produktnotizen

• Dieser Branch ersetzt die ältere self / reflect / anchor-Oberfläche durch das continuity-Aktionsmodell.

• Das Designziel ist einfache lokale Kontinuität: Snapshots, Entscheidungen, Zustandsdatensätze, Themen und Entitäten.

• Such- und Nachbarschaftsabfragen geben absichtlich zuerst kompakte Zeilen zurück, damit Agenten den nahegelegenen Kontext inspizieren können, ohne Token zu verschwenden.

• Gemeinsame theme-, entity- und project-Knoten können ansonsten separate Artefakte zu einem navigierbaren Kontinuitätsgraph verbinden.

• node und related halten den Graphen überprüfbar, ohne vollständige Graph-Dumps in den Kontext zu erzwingen.

• doctor, export, backup und import sind bewusst CLI-first, damit große Wartungsarbeiten explizit und lokal bleiben.

v3 Migration

claude-memory-mcp stellt jetzt eine Kontinuitäts-first-API bereit.

Entfernt:

• self

• reflect

• anchor

Hinzugefügt:

• continuity MCP-Dispatch-Tool

• claude-memory-mcp CLI-Befehle für save, list, search, get, neighbors, node, related, doctor, export, backup, import, bundle, merge und delete

• SQLite-basierte Kontinuitätsartefakte für Snapshots, Entscheidungen, Zustandsdatensätze, Bundles und Meta-Snapshots

Datenschutzrichtlinie

Alle Daten befinden sich lokal auf Ihrem Rechner.

• Datenerfassung: keine

• Telemetrie: keine

• Netzwerkaufrufe: keine

• Weitergabe an Dritte: keine

Löschen Sie die Datenbankdatei, um gespeicherte Kontinuitätsartefakte zu entfernen.

Support

• Probleme: github.com/whenmoon-afk/claude-memory-mcp/issues

• Repository: github.com/whenmoon-afk/claude-memory-mcp

Lizenz

MIT