mcp-server-zep-cloud

MCP-Server für Zep Cloud

MCP Server für Zep Cloud stellt eine Brücke zwischen LLM-Clients und der Zep Cloud-API her und ermöglicht die Speicherverwaltung für KI-Assistenten.

Überblick

Ein MCP-Server zum Speichern und Abrufen von Benutzererinnerungen, Präferenzen, Verfahren und Sachzusammenhängen über die Zep Cloud API. Er fungiert als semantische Speicherschicht, die es KI-Assistenten ermöglicht, den Kontext über Benutzer über Konversationen hinweg beizubehalten.

Werkzeuge

Benutzerverwaltung :
- create_user : Erstellen Sie einen neuen Benutzer in Zep Cloud
- get_user : Details eines Benutzers abrufen
- update_user : Aktualisieren Sie die Metadaten eines Benutzers
- delete_user : Einen Benutzer löschen
- list_users : Alle Benutzer auflisten
Graphoperationen :
- search_graph : Durchsuchen Sie das Speicherdiagramm eines Benutzers
- add_graph_data : Daten zum Speicherdiagramm eines Benutzers hinzufügen
Konnektivität :
- check_connection : Überprüfen Sie den Verbindungsstatus mit der Zep Cloud API

Umgebungsvariablen

Name	Beschreibung	Standardwert
`ZEP_API_KEY`	API-Schlüssel für den Zep Cloud-Dienst	Keiner
`MCP_HOST`	Host, an den der Server gebunden werden soll	`0.0.0.0`
`MCP_PORT`	Port, auf dem der Server ausgeführt wird	`8080`

Installation

Schmiedekunst verwenden

npx @smithery/cli install mcp-server-zep-cloud --client claude

Manuelle Installation mit Claude Desktop

Klonen Sie dieses Repository:

git clone https://github.com/yourusername/mcp-server-zep-cloud.git
cd mcp-server-zep-cloud

Installieren Sie Abhängigkeiten:

pip install -r config/requirements.txt

Konfigurieren Sie Claude Desktop, indem Sie zu claude_desktop_config.json Folgendes hinzufügen:

{
  "mcpServers": {
    "zep-cloud": {
      "command": "python",
      "args": ["/path/to/mcp-server-zep-cloud/core/run_server.py"],
      "env": {
        "ZEP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Die Konfigurationsdatei befindet sich unter:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Verwenden von Docker

Zum Erstellen und Ausführen des MCP-Servers steht ein Dockerfile zur Verfügung:

# Build the container
docker build -t mcp-server-zep-cloud .

# Run the container
docker run -p 8080:8080 \
  -e ZEP_API_KEY="your-api-key" \
  mcp-server-zep-cloud

Fallback-Modus

Wenn der Server keine Verbindung zur Zep Cloud API herstellen kann, startet er automatisch im Fallback-Modus:

Alle API-Operationen werden simuliert und geben Erfolg zurück
Es werden keine tatsächlichen Daten an die Zep Cloud API gesendet oder von ihr empfangen
Der Server bleibt betriebsbereit, sodass die Client-Integration funktioniert
Warnmeldungen werden protokolliert, um den Fallback-Modus anzuzeigen

Repository-Struktur

core/ : Dateien mit den Kernfunktionen
- zep_cloud_client.py : Client-Implementierung für die Zep Cloud API
- zep_cloud_server.py : MCP-Server, der Tools für den API-Zugriff bereitstellt
- run_server.py : Standalone-Skript zum direkten Ausführen des Servers
scripts/ : Hilfsskripte für Operationen und Tests
- check_user_exists.py : Dienstprogramm zum Überprüfen, ob ein Benutzer existiert
- create_specific_user.py : Skript zum Erstellen von Testbenutzern
- run_server.sh / run_server.bat : Shell-Skripte zum Ausführen des Servers
tests/ : Testskripte
- test_zep_cloud_client.py : Unit-Tests für den Zep Cloud-Client
- test_server_initialization_fixes.py : Tests zur Serverinitialisierung
config/ : Konfigurationsdateien
- .env.example : Vorlage für die Umgebungskonfiguration
- requirements.txt : Paketabhängigkeiten

Sicherheitsüberlegungen

Schutz von API-Schlüsseln : Übergeben Sie Ihren API-Schlüssel niemals der Versionskontrolle
Umgebungsvariablen : Verwenden Sie Umgebungsvariablen für vertrauliche Daten
Eingeschränkter Zugriff : Beschränken Sie den Server auf vertrauenswürdige Netzwerke

Support für andere Clients

Dieser MCP-Server ist für die Zusammenarbeit mit jedem MCP-kompatiblen Client konzipiert. Er wurde getestet mit:

Claude Desktop
Claude im Webbrowser

Entwicklung

Ausführen von Tests

cd tests
python test_zep_cloud_client.py
python test_server_initialization_fixes.py

Ausführen im Entwicklungsmodus

cd scripts
./run_server.sh

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert.