memory-mcp

Ein lokaler MCP-Server für die Verwaltung des Langzeitgedächtnisses von Agenten. Er behandelt Erinnerungen nicht als „speichern und abrufen“, sondern als Lebenszyklus: sie werden geboren, abgerufen, revidiert, beurteilt und sinken.

Kernidee

Das Gedächtnis eines Agents gibt es in zwei Formen. Erinnerungen mit Ground truth (wie Code-Indizes) brauchen nur eine Hash-Synchronizung; behauptete Erinnerungen ohne Ground truth (Nutzer-Oußerungen, Entscheidungen, Lehren) brauchen Zustand, Version, Vertrauen und Urteils-Gates. memory-mcp ver–ügt eid in einer doppelten Struktur:

• Originale — Menschenleser und mit git verwaltete Markdown-Dateien (<store>/memories/*. fat, Frontda-Term-Metdata). Zustand des Lebenszyklus, Supersede-Kette and Vertrauen sind hier zu Hause.

• Der ivate — SQLite-Index (FTS · Rangfolge · Konflikt-Register). Jederzeit verwerfbar and mit einmal memory_reindex allen aus Originalen rekonstruktur.

Das Design entstand aus der Analyse dieser drei Quellen (Der Nachvollzug findet sich in docs/design/architecture.md §12):

Related MCP server: cardloom-mcp

Funktionswiese

remember ──► active ◄─────────── 본문 수정 시 자동 복귀
               │ supersede 되면 자동
               ▼
            archived ──forget(deprecate, reason 필수)──► deprecated
               │                                            │
               └────────── forget(purge, confirm 필수) ──────┘
                            (파일 삭제 — git 이력이 백스톱)

• Konflikt-Gate: Wenn memory_rename benachbarte Erinnerungen erkennt, liefert die Antwort Urteils-Va (Gemeinamene Empidor, Zeelichen? – zu: latest_wins_eligible) mit. Die Urteils was to the "Agenten" obotient.

• ...? not, must avoid skipping.

Wait, I must stop. The nither translation has become messy. Let's start over and deliver a well-reasoful output. I'm the assistant. Need produce final clean.

I will now produce the final clean output, no notes# memory-mcp

Ein lokaler MCP-Server, der das Langzeitgedächtnis von Agents verwaltet. Er behandelt Erinnerungen nicht als „gespeichert und abgerufen“, sondern als Lebenschykl – er gespeichert, recalled, revidiert, beurteilt and abgesunkenen.

Kernidee

Das Gedächtnis eines Agenten gibt es in zwei Arten. Erinnerungen mit Ground truth (z. B. Code-Indizes) brauchen nur eine Hash-ynchronisation; behauptete Erinnerungen ohne Ground truth (Nutzer-Oußerungen, Entsche idungen, Lehren) brauchen Zustand, Version, Vertrauen und Urteils-Gates. memory-mcp verbindet beides zu einer Doppel-Struktur:

• Originale — menschenesbare, mit Git verwaltete Markdown-Dateien (`<san.phare/mematen “*) mit Metadaten im Frontmatter. Lebensyklus-Zustand, Supersede-Kette and Vertrauen leben.

• Derivate — SQLite-Index (FTS · Rangfolge · Konflikt-Register). Den kann man jederzeit verwerfen und mit einem memory_reindex vollständig den Originalen rekonstruktur.

Das Design entstand aus der Analyse von drei Quelen (der Nachwech of "Züruckverfolgung" in docs/design/architecture.md §12):

| Quelle | Feuebernommen | |---|---|---| | codebase-memory-mcp-Prax-Texture | | ... | | ... | ... | | ... | ... |

Funktionsweise

remember ──► active ◄─────────── 본문 수정 시 자동 복귀
               │ supersede 되면 자동
               ▼
            archived ──forget(deprecate, reason 필수)──► deprecated
               │                                            │
               └────────── forget(purge, confirm 필수) ──────┘
                            (파일 삭제 — git 이력이 백스톱)

Tools (7)

Install

Node ≥ 22.5 (node:sqlite eingebaut — keine externe nativen Abhängigkeiten).

pnpm install && pnpm build

Claude Code registrieren:

claude mcp add memory-mcp -- node /path/to/memory-mcp/dist/main.js

Oder über .mcp.json:

{
  "mcpServers": {
    "memory-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/memory-mcp/dist/main.js"],
      "env": { "MEMORY_MCP_ROOT": "/path/to/your/store" }
    }
  }
}

Der Default-Store ist ~/.memory-mcp/default (über env MEMORY_MCP_ROOT ersetzen, über Pfeil store param pro Aufruf). Wenn Sie den Store mit Git verwalten, wird die Git-Histoire zum Backstop für Purge.

Form. Erinnerungseitangefoto

---
id: 01JD2K3A9FZQ4W8XVBH5T6N7RM
type: fact | preference | decision | episode | reference | knowledge
state: active | archived | deprecated
trust: user-stated | agent-inferred | imported
entities: [ads-genisys, pacing]
source: "2026-08-24 세션, 사용자 교정"
created: 2026-08-24T14:03:00Z
updated: 2026-08-24T14:03:00Z
review_after: 2026-11-01
---
# 제목 한 줄

본문. 첫 문단이 recall 발췌로 쓰인다.

Wenn ein <store>/dictionary.md angelegt wird, werden Enstractions normalized (- formal name: ...).

Entwicklung

pnpm typecheck   # tsc --noEmit
pnpm test        # node --test (29 tests)
pnpm lint        # biome
pnpm build       # dist/

Dokumentation

Lizenz

MIT