Mem0 MCP Server

Mem0 MCP-Server

Ein Model Context Protocol (MCP)-Server zur Integration von KI-Assistenten in das persistente Speichersystem von Mem0.ai.

Überblick

Dieser Server bietet MCP-kompatible Tools, mit denen jeder kompatible KI-Assistent auf die in Mem0 gespeicherten persistenten Speicher zugreifen und diese verwalten kann. Er fungiert als Brücke zwischen KI-Modellen und dem Mem0-Speichersystem und ermöglicht Assistenten Folgendes:

• Erinnerungen speichern und abrufen
• Suche nach Erinnerungen mit semantischer Ähnlichkeit
• Verwalten Sie verschiedene Gedächtnistypen (episodisch, semantisch, prozedural)
• Nutzen Sie das Kurzzeitgedächtnis für den Gesprächskontext
• Selektive Gedächtnismuster anwenden
• Wissensgraphen aus Erinnerungen erstellen

Projektstruktur

Der Projektcode befindet sich im Verzeichnis src/mcp_mem0_general/ .

Erste Schritte (keine Installation erforderlich!)

Dieser Server kann mit uvx direkt von GitHub aus ausgeführt werden, ohne dass das Repository geklont oder lokal installiert werden muss.

Ausführen des Servers

Stellen Sie sicher, dass Sie uv installiert haben ( pipx install uv oder brew install uv ).

Sie können den Server direkt in Ihrem Terminal testen:

Der Server sollte starten und seine Initialisierungsschritte protokollieren.

Einrichten in Cursor oder Claude Desktop

1. uvx -Pfad ermitteln: GUI-Anwendungen wie Claude Desktop verwenden oft nicht denselben PATH wie Ihr Terminal. Ermitteln Sie den vollständigen Pfad zu Ihrer uvx Programmdatei, indem Sie Folgendes in Ihrem Terminal ausführen:
   which uvx
   Kopieren Sie den Ausgabepfad (z. B. /Users/yourname/.local/bin/uvx oder /opt/homebrew/bin/uvx ).
2. MCP konfigurieren: Fügen Sie Ihrer MCP-Konfigurationsdatei die folgende Konfiguration hinzu und ersetzen Sie /full/path/to/uvx durch den tatsächlichen Pfad, den Sie in Schritt 1 gefunden haben.
   • Cursor: Hinzufügen/Aktualisieren in ~/.cursor/mcp.json :
   • Claude Desktop: Fügen Sie in Ihren Einstellungen eine ähnliche Konfiguration hinzu/aktualisieren Sie sie.
   "mem0-memory-general": { "command": "/full/path/to/uvx", # <-- IMPORTANT: Use the full path from 'which uvx' "args": [ "git+https://github.com/ryaker/mcp-mem0-general.git", "mcp-mem0-general" ], "env": { "MEM0_API_KEY": "your-mem0-api-key-here" } }
3. Neustart: Starten Sie Cursor oder Claude Desktop neu, um die Änderungen zu übernehmen. Der Server sollte nun innerhalb der Anwendung korrekt starten.

Hinweis zu mem0ai[neo4j] Warnung

Möglicherweise wird beim Start eine Warnung wie warning: The package mem0ai==0.1.96 does not have an extra named neo4j .

• Bei Verwendung der verwalteten Mem0.ai-Plattform: Diese Warnung kann ignoriert werden. Die erforderliche Graphenverarbeitung erfolgt serverseitig auf der Mem0-Plattform.
• Wenn Mem0 mit Neo4j selbst gehostet wird: Diese Warnung weist darauf hin, dass die jeweilige mem0ai Version Neo4j-bezogene Python-Bibliotheken ( langchain-neo4j , neo4j ) nicht automatisch installiert hat. Sie müssen sicherstellen, dass diese manuell in Ihrer selbstgehosteten Umgebung installiert werden, wenn Sie Graph-Funktionen verwenden.

Laden des Benutzerhandbuchs in den Speicher (empfohlen)

Um Ihrem KI-Assistenten den Zugriff auf die Serverfunktionen zu erleichtern, können Sie den Inhalt von USAGE_GUIDE.md in Mem0 laden. Gehen Sie dazu folgendermaßen vor:

Voraussetzung: Stellen Sie sicher, dass der Mem0 MCP-Server in Ihrem KI-Assistenten (Claude/Cursor) ausgeführt wird und richtig konfiguriert ist, wie im Abschnitt „Erste Schritte“ oben beschrieben.

1. Kopieren Sie den Inhalt des Handbuchs: Öffnen Sie die Datei USAGE_GUIDE.md . Markieren und kopieren Sie den gesamten Textinhalt.
2. Assistenten bitten, Speicher hinzuzufügen: Rufen Sie Ihren KI-Assistenten (Claude/Cursor) auf und verwenden Sie eine ähnliche Eingabeaufforderung. Fügen Sie den kopierten Anleitungsinhalt an der angegebenen Stelle ein. Achten Sie darauf, Ihre konsistente user_id (z. B. „default_user“) zu verwenden.

Bitte beachten Sie die folgende Anleitung zur Verwendung des Mem0 MCP-Servers. Verwenden Sie die Benutzer-ID "default_user" und fügen Sie die Metadaten {"title": "Mem0 MCP Usage Guide", "source": "README Instruction"} hinzu:

[--- FÜGEN SIE HIER DEN GESAMTEN INHALT VON USAGE_GUIDE.md EIN ---]

4. Rufen Sie den Leitfaden später ab: Da Sie nun die ID haben, können Sie Ihren Assistenten jederzeit schnell bitten, den vollständigen Leitfaden mit einer Eingabeaufforderung wie dieser abzurufen:

Speichertypen

Der Server unterstützt verschiedene Speichertypen, sortiert nach Dauer und Funktion:

Kurzzeitgedächtnis

• Konversationsspeicher : Abrufen der letzten Nachrichtenaustausche
• Arbeitsgedächtnis : Temporäre Informationen, die aktiv genutzt werden
• Aufmerksamkeitsgedächtnis : Informationen, die aktuell im Fokus stehen

Langzeitgedächtnis

• Episodisches Gedächtnis : Bestimmte Ereignisse und Erfahrungen
• Semantisches Gedächtnis : Fakten, Konzepte und Wissen
• Prozedurales Gedächtnis : Fähigkeiten und praktische Informationen

Erweiterte Funktionen

• Benutzerdefinierte Kategorien : Definieren und verwalten Sie Ihre eigenen Speicherkategorien
• Speicheranweisungen : Legen Sie Richtlinien fest, wie Erinnerungen verarbeitet werden sollen
• Graph Relations : Zugriff auf Wissensgraph-Beziehungen zwischen Entitäten
• Selektives Gedächtnis : Filtern Sie Text vor dem Speichern mit Einschluss-/Ausschlussmustern
• Feedback-Mechanismus : Geben Sie Feedback zur Speicherqualität

Verwendung

Alle Speicher im System verwenden „default_user“ als Standard-Benutzer-ID.

Ausführliche Anwendungsbeispiele finden Sie in USAGE_GUIDE.md .

Dokumentation

• Erste Schritte
• API-Referenz
• Speichertypen
• Erweiterte Funktionen
• Konfiguration

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Danksagung

• Mem0.ai für ihre hervorragende Speicher-API
• Model Context Protocol (und sein Python SDK mcp ) für die Serverimplementierung
• Alle Mitwirkenden an diesem Projekt