memory-mcp

Persönlicher, toolübergreifender Speicher: Kalender, ein durchsuchbares episodisches Archiv von KI-Sitzungen von allen Geräten sowie eine kuratierte, hochvertrauenswürdige semantische Faktenebene, bereitgestellt über einen MCP-Server. Entwickelt für eine selbst gehostete arm64-Box, nur über WG erreichbar. Das vollständige Design finden Sie unter docs/mcp/memory-mcp-spec.md.

Aufbau

Related MCP server: Mnemo

Zwei Ebenen, zwei Vertrauensstufen

• Episodisches Archiv (Qdrant memory_archive): jeder Chunk jeder Sitzung. Dichte (bge-m3, 1024) plus sparse (IDF-modifizierte TF) Vektoren, RRF-fusionierte Hybrid- Suche. Nur bei Bedarf durchsucht (search_archive).

• Semantische Fakten (Postgres): kuratierte Aussagen mit Herkunftsbeleg. Standarbeitsfläche (search_memory). Geschrieben von remember (Quelle user) und von menschlich freigegebener Distillierung (Quelle distilled) — nichts Distilliertes wird ohne memoryctl review aktiviert.

MCP-Schnittstelle

Tools: remember, search_memory, search_archive, forget (zerstörend, zweiphasig nach Abfrage). Ressourcen: memory://stats, memory://facts/recent, memory://facts/{id}.

Entwicklung

pnpm install
pnpm build        # all packages
pnpm test         # core + server suites (stores are mocked; nothing external touched)
pnpm eval         # golden-set retrieval harness (needs live stores + ingested data)

Konfiguration erfolgt über die Umgebung durch packages/core/src/config.ts (loadConfig) — alle Variablen finden Sie in deploy/.env.example.

Betriebs

cd deploy && cp .env.example .env   # fill in POSTGRES_PASSWORD, STATIC_BEARER, keys
docker compose -f compose.prod.yaml up -d --build
docker compose -f compose.prod.yaml exec memory-mcp memoryctl init
docker compose -f compose.prod.yaml exec memory-mcp memoryctl verify

compose.prod.yaml setzt voraus, dass Qdrant und ein OpenAI-kompatibles LLM-Gateway bereits als externe Container auf Ihrem Server laufen — networks:-Abschnitt name:-Felder an Ihre eigenen Docker-Netzwerknamen anpassen.

Tägliche Ingest- und Distill-Läufe sowie nächtliche Backups werden als systemd-Timer (deploy/systemd/) ausgeführt. Backups verfallen nach 14 Tagen, sodass ein forget innerhalb dieses Zeitfensters aus den Backups verschwindet.

Sicherheitsansatz

• Nur-WG-Bindung, statisches Bearer-Token (v1); Gateway-JWT ist ein geplantes zukünftiges Authentifizierungsmodell (Schritt 8), sobald ein kompatibles OIDC/JWT-Gateway vor dem Server verfügbar ist.

• Das Scrubbing (gitleaks + benutzerdefinierte RegExes) ist fail-closed und läuft bevor etwas eingebettet oder gespeichert wird. Nicht verarbeitbare Eingaben stellen die gesamte Datei unter Quarantäne (im Ledger festgehalten); vorübergehende Infrastrukturfehler (Embedder, Qdrant oder gitleaks nicht verfügbar) rollen sauber zurück, zeichnen nichts auf, und die Datei wird beim nächsten Lauf erneut versucht.

• forget ist ein hartes Löschen in beiden Speichern.

• Archiv-Chunks werden innerhalb von Begrenzern für unvertrauenswürdige Daten zurückgegeben — historische Transaktionen von Google? Das kannst du nicht wissen. einen anweisungsartigen Text enthalten und müssen als Daten behandelt werden.

Siehe SECURITY.md, um eine Schwachstelle zu melden.

Mitwirken

Issues und PRs sind willkommen — siehe CONTRIBUTING.md für Entwicklungs­ Setup und Projektkonventionen und CHANGELOG.md für die Historie. Dieses Projekt befolgt den Verhaltenskodex.

Lizenz

• MIT