memory-mcp

Langzeitgedächtnis-MCP-Server für OpenCode – speichert Präferenzen, Lektionen und Nutzungshistorie in einer einzigen lokalen SQLite-Datei (100 % lokal, keine externe API), damit die KI durch kontextbasiertes Lernen den Benutzer „merken und sich anpassen“ kann.

Status: v1.1.0 – alle 4 Phasen implementiert, Tests bestehen 70/70 Assertions (Smoke 53 + Capture 8 + Distill 9)

ไทย / Thai: README.th.md

Architecture

OpenCode ──┬─ Plugin learning-capture (Bun)  ── auto-captures prompts/tool/error into DB
            │                                   └─ injects profile back into context on compaction
            └─ MCP memory-mcp (Node.js stdio)  ── 9 tools read/write the same SQLite DB
                                                      ▲
                               Global instructions (memory-protocol.md) teach the AI to use the tools

Siehe design.md für vollständige Details.

Related MCP server: MCP Vector Memory

Scripts

Tools (9)

Install with OpenCode

1. Fügen Sie den mcp-Abschnitt aus opencode.example.json in Ihre opencode.json ein (global oder auf Projektebene)

   • Wichtig: Setzen Sie MEMORY_DB_PATH auf DIESELBE Datenbankdatei für Server und Plugin (das Beispiel verwendet <ABSOLUTE_PATH>/memory-mcp/data/memory.db), sonst schreibt das Auto-Capture-Plugin in eine andere DB als die, die die KI liest

   • So legen Sie es fest (eine Option wählen):

     • definieren Sie es in der mcp-environment (siehe Beispiel) – deckt nur den MCP-Server ab

     • oder setzen Sie es als System-/Benutzer-Umgebungsvariable (z. B. setx MEMORY_DB_PATH "D:/path/to/memory.db" unter Windows) – deckt Server und Plugin ab, da das Plugin im selben Prozess wie OpenCode läuft

2. Fügen Sie die globalen Speicherregeln hinzu – fügen Sie zu opencode.json hinzu:

   "instructions": ["C:/Users/<user>/.config/opencode/memory-protocol.md"]

   (Beispielregelinhalt befindet sich in AGENTS.memory.example.md – kann stattdessen auf Projektebene angehängt werden)

3. (Optional) Auto-Capture-Plugin bereitstellen: Kopieren Sie src/plugin/learning-capture.ts → ~/.config/opencode/plugins/learning-capture.ts

4. OpenCode neu starten (Konfiguration wird nur beim Start geladen)

5. Test: „Merken Sie sich, dass ich pnpm bevorzuge“ → eine neue Sitzung öffnen und zurückfragen

Daily usage

Die KI akzeptiert Thai und Englisch gleichermaßen – Sie können jederzeit ohne Vorwarnung die Sprache wechseln.

Langzeitpflege: Führen Sie gelegentlich npm run distill aus, um Statistiken zusammenzufassen und Interaktionen zu bereinigen, die älter als 30 Tage sind.

data/ structure

data/
├── memory.db          # SQLite (WAL mode) — main DB (+ .db-wal, .db-shm)
└── exports/           # JSON files from export_memory (writeable only in this dir)

• DB-Pfad kann über die Umgebungsvariable MEMORY_DB_PATH überschrieben werden

• alles in data/ ist git-ignoriert