mcp-memory-service MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Semantic search with tag filtering over durable memories
Backends: SQLite-vec (local), ChromaDB, Cloudflare, hybrid
5ms local retrieval; background consolidation with decay
REST API (15 endpoints) for use outside MCP clients
OAuth 2.0 + PKCE for browser-based claude.ai integration

Live-Demo

In der Praxis

memory-service.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": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "memory-service": {
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memory-service",
      "command": "uvx",
      "args": [
        "mcp-memory-service"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "memory-service": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-memory-service"
        ]
      }
    }
  }
}

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

claude mcp add memory-service -- uvx mcp-memory-service

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

Anwendungsfälle

Praxisnahe Nutzung: mcp-memory-service

How to give Claude stable memory of your preferences and context

👤 Daily power users tired of re-explaining themselves ⏱ ~10 min beginner

Wann einsetzen: Every new chat starts from scratch and you want continuity.

Voraussetzungen

uvx installed — brew install uv

Ablauf

Seed preferences

memory_store: 'I work on iOS + Swift projects. Prefer MVVM with @Observable. Always comment in English.' with tags [preference, coding].✓ Kopiert

→ Stored confirmation
In a future session, retrieve

memory_search: 'my coding style preferences'.✓ Kopiert

→ Preferences returned, agent applies them
Decay cleanup

Show me memories older than 90 days with no recent hits — offer to prune.✓ Kopiert

→ Stale list for review

Ergebnis: Claude behaves like it remembers you.

Fallstricke

Storing sensitive PII that becomes retrievable forever — Don't — treat memory like a public notebook. Use tags to compartmentalize.

How to share a memory pool across a team via Cloudflare backend

👤 Teams running shared AI workflows ⏱ ~30 min advanced

Wann einsetzen: You want every engineer's chat to remember the same architectural decisions.

Voraussetzungen

Cloudflare account with Workers KV or D1 — cloudflare.com, set up as per the Cloudflare backend docs

Ablauf

Switch backend

Configure MCP_MEMORY_BACKEND=cloudflare with CF creds in env.✓ Kopiert

→ Memory endpoints point to CF
Seed team-shared memory

memory_store: 'Our auth lives in services/auth. Always rotate JWT keys via the rotate-keys Make target.' with tag 'team-arch'.✓ Kopiert

→ Stored
Verify from a second machine

memory_search 'auth service' — should return the same entry.✓ Kopiert

→ Cross-device hit

Ergebnis: Shared institutional memory that survives team turnover.

Fallstricke

Sensitive data in shared memory leaks cross-team — Run separate backends per team; don't store secrets

How to auto-harvest learnings at the end of a coding session

👤 Solo devs using agents heavily ⏱ ~5 min beginner

Wann einsetzen: At the end of a pair-programming chat, before closing.

Ablauf

Run the harvester

memory_harvest on this conversation — extract durable facts (API keys patterns, project decisions, known gotchas). Ignore chit-chat.✓ Kopiert

→ Structured list of candidate memories
Approve + save

Save items 1, 3, 5 as memories with tag 'project-x'. Drop the rest.✓ Kopiert

→ Count saved

Ergebnis: Low-friction capture of what you learned, nothing more.

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

memory-service + contextplus

Use Context+ for live repo state, memory-service for durable cross-session facts

Save this architectural decision to memory-service and link it to the relevant files via Context+ memory graph.✓ Kopiert

memory-service + github

After each merged PR, harvest learnings into memory

Summarize the last 10 merged PRs in org/repo, extract repeat mistakes, and store them as memories with tag 'code-review-lessons'.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
memory_store	content: str, tags?: str[]	Save a durable fact	1 embedding
memory_search	query: str, tags?: str[], limit?: int	Retrieve relevant memories	1 vector search (local)
memory_harvest	transcript: str	End-of-session capture	1 LLM call
memory_store_session	session_id, messages	Ingest a whole chat	N embeddings

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: SQLite-vec: unlimited local. ChromaDB: local. Cloudflare: Workers/KV/D1 free tier is generous.
Tokens pro Aufruf: Store: ~100 tokens for content. Search: ~50 tokens per result.
Kosten in €: Free (open source). Cloudflare backend: free tier usually enough.
Tipp: Start with SQLite-vec. Switch to hybrid only when you need multi-device sync.

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Local filesystem for SQLite mode Cloudflare API token for CF mode

Credential-Speicherung: CF creds via env vars

Datenabfluss: Local (SQLite) or your Cloudflare account (CF)

Niemals gewähren: Don't let untrusted prompts call memory_store — poisoning attacks

Memory is long-lived by default — deleting a memory doesn't erase it from LLM context that already saw it.
OAuth 2.0 + PKCE remote mode exposes an HTTP surface; keep it behind auth.

Fehlerbehebung

Häufige Fehler und Lösungen

ModuleNotFoundError: sqlite_vec

pip/uv install with the sqlite-vec extra: uvx 'mcp-memory-service[sqlite]'

Prüfen: python -c 'import sqlite_vec'

Cloudflare backend 403

Token lacks Workers/KV permissions. Create a new CF API token with the specific scopes.

Memories returned aren't relevant

Re-embed with a better model — defaults to local MiniLM; upgrade to nomic-embed via env var.

memory_harvest outputs duplicates

Enable the dedup config; harvester will skip items with cosine similarity > 0.95 to existing.

Alternativen

mcp-memory-service vs. andere

Alternative	Wann stattdessen	Kompromiss
mem0	You want a hosted memory SaaS	Paid beyond free tier; vendor-locked
contextplus memory graph	You want memory tightly integrated with code understanding	Scoped to a repo, not general-purpose

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen