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.

Related MCP server: Frinus MCP Server

Werkzeuge

1. 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

2. Graphoperationen :

   • search_graph : Durchsuchen Sie das Speicherdiagramm eines Benutzers

   • add_graph_data : Daten zum Speicherdiagramm eines Benutzers hinzufügen

3. Konnektivität :

   • check_connection : Überprüfen Sie den Verbindungsstatus mit der Zep Cloud API

Umgebungsvariablen

Installation

Schmiedekunst verwenden

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

Manuelle Installation mit Claude Desktop

1. Klonen Sie dieses Repository:

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

2. Installieren Sie Abhängigkeiten:

pip install -r config/requirements.txt

3. 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.