memo-mcp

memo-mcp ist ein geschützter Streamable-HTTP-MCP-Gateway für eine private, selbst gehostete Mem0-REST-API. Er stellt eine kleine, nicht destruktive Schnittstelle für Speicher-Tools bereit und hält Mem0, PostgreSQL und interne API-Zugangsdaten vom öffentlichen Netzwerk fern. Er ist als Referenzimplementierung für einen vertrauenswürdigen Speicherbereich gedacht. Bevor Sie es mehreren Personen erlauben, integrieren Sie einen serverseitigen Richtlinienadapter, der den Speicherbereich aus der authentifizierten Mitgliedschaft ableitet. Lassen Sie niemals zu, dass ein Browser oder MCP-Client MEMORY_SCOPE wählt.

Sicherheitsmodell

• Mem0 bleibt privat; stellen Sie nur dieses Gateway über einen Reverse-Proxy bereit.

• Nicht-Browser-Clients verwenden ein eigenes, widerrufbares Bearer-Token.

• Browser-Clients können die OAuth/OIDC-Token-Introspection mit exakten Prüfungen von Issuer, Audience, unveränderlichem Subject und Scope verwenden.

• memo_remember_fact erfordert mem0.write für OAuth-Clients.

• Der Gateway bietet bewusst kein Löschwerkzeug für den Speicher. Führen Sie Löschungen über einen separaten, privaten administrativen Workflow mit ausdrücklicher Genehmigung durch.

• Der Gateway weist übliche Formate von Zugangsdaten und privaten Schlüsseln ab, bevor sie in den Speicher geschrieben werden können. Das ist ein Sicherheitsnetz, kein Ersatz für die Richtlinien des Betreibers.

• Ein Aufrufer darf niemals seinen eigenen Speicherbereich wählen. In Multi-User-Umgebungen muss eine vertrauenswürdige Anwendung den Speicherbereich aus der serverseitigen Mitgliedschaft ableiten.

Related MCP server: memex

Schnellstart

1. Kopieren Sie .env.example nach .env und ersetzen Sie jeden Platzhalter mit Ihren eigenen privaten Werten. Committen Sie .env nicht.

2. Erstellen Sie ein privates Docker-Netzwerk und starten Sie den Dienst mit docker compose -f compose.example.yml up -d --build.

3. Leiten Sie ausschließlich den Gateway über HTTPS weiter. Veröffentlichen Sie weder Mem0 noch PostgreSQL oder eine befüllte Umgebungsdatei.

4. Verifizieren Sie, dass die Metadaten der geschützten Ressource bei aktiviertem OAuth 200 zurückliefern und eine anonyme /mcp-Anfrage den Status 401 liefert.

Tools

• memo_search_memory

• memo_remember_fact

Konfiguration

Siehe .env.example. PUBLIC_MCP_URL, MCP_ALLOWED_HOSTS und MCP_ALLOWED_ORIGINS müssen Ihren eigenen HTTPS-Endpunkt beschreiben. Der Gateway ruft die Mem0-API mit X-API-Key auf.

MCP_ALLOWED_HOSTS ist Pflicht. Der Container-Build-Kontext schließt .env, Git-Metadaten und lokale Python-Artefakte aus, damit diese nicht versehentlich in ein Image kopiert werden.

Entwicklung

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python -m unittest discover -s tests -v

Dieses Projekt verwendet das offizielle Python MCP SDK.