mcp-server-zep-cloud

Zep Cloud用MCPサーバー

Zep Cloud 用の MCP サーバーは、LLM クライアントと Zep Cloud API 間のブリッジを提供し、AI アシスタントのメモリ管理を可能にします。

概要

Zep Cloud APIを介してユーザーの記憶、好み、手順、事実関係を保存・取得するためのMCPサーバー。AIアシスタントが会話全体を通してユーザーに関するコンテキストを維持できるようにするセマンティックメモリレイヤーとして機能します。

ツール

1. ユーザー管理:
   • create_user : Zep Cloud に新しいユーザーを作成する
   • get_user : ユーザーの詳細を取得する
   • update_user : ユーザーのメタデータを更新する
   • delete_user : ユーザーを削除する
   • list_users : すべてのユーザーを一覧表示する
2. グラフ操作:
   • search_graph : ユーザーのメモリグラフを検索する
   • add_graph_data : ユーザーのメモリグラフにデータを追加する
3. 接続性:
   • check_connection : Zep Cloud API との接続ステータスを確認する

環境変数

インストール

鍛冶屋を使う

Claude Desktop による手動インストール

1. このリポジトリをクローンします:

2. 依存関係をインストールします:

3. claude_desktop_config.jsonに以下を追加して、Claude Desktop を構成します。

設定ファイルは次の場所にあります。

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

Dockerの使用

MCP サーバーを構築および実行するための Dockerfile が利用可能です。

フォールバックモード

サーバーが Zep Cloud API に接続できない場合は、自動的にフォールバック モードで起動します。

• すべてのAPI操作はシミュレートされ、成功を返します
• Zep Cloud APIとの間で実際のデータは送受信されません。
• サーバーは動作を継続し、クライアント統合が機能する。
• フォールバックモードを示す警告メッセージが記録されます

リポジトリ構造

• core/ : コア機能ファイル
  • zep_cloud_client.py : Zep Cloud API のクライアント実装
  • zep_cloud_server.py : API アクセス用のツールを提供する MCP サーバー
  • run_server.py : サーバーを直接実行するためのスタンドアロンスクリプト
• scripts/ : 操作とテスト用のユーティリティスクリプト
  • check_user_exists.py : ユーザーが存在するかどうかを確認するユーティリティ
  • create_specific_user.py : テストユーザーを作成するスクリプト
  • run_server.sh / run_server.bat : サーバーを実行するためのシェルスクリプト
• tests/ : テストスクリプト
  • test_zep_cloud_client.py : Zep Cloud クライアントのユニットテスト
  • test_server_initialization_fixes.py : サーバーの初期化のテスト
• config/ : 設定ファイル
  • .env.example : 環境設定のテンプレート
  • requirements.txt : パッケージの依存関係

セキュリティに関する考慮事項

• APIキーの保護: APIキーをバージョン管理にコミットしないでください
• 環境変数: 機密データには環境変数を使用する
• アクセス制限: サーバーを信頼できるネットワークに制限します

他のクライアントのサポート

このMCPサーバーは、MCP互換のあらゆるクライアントで動作するように設計されています。以下の環境でテスト済みです。

• クロードデスクトップ
• ウェブブラウザのクロード

発達

テストの実行

開発モードで実行

ライセンス

この MCP サーバーは MIT ライセンスに基づいてライセンスされます。