MCP Server Zep Cloud

🚀 Zep Cloud MCP サーバー

Zep Cloud MCP サーバーは、Claude Desktop と Zep Cloud API の間の橋渡しを行い、AI アシスタントのメモリ管理を実現します。

📦 インストール

1. リポジトリのクローン

git clone [your-repository-url]
cd mcp-server

2. 仮想環境の作成とアクティブ化（推奨）

python -m venv venv
source venv/bin/activate  # Windows の場合は `venv\Scripts\activate` を使用
pip install -r requirements.txt

3. 環境変数の設定

• .env.example を .env にコピーし、API キーを追加します。

  cp .env.example .env
  nano .env
  

  以下の内容を更新します。

  ZEPCLOUD_API_KEY=your_api_key_here
  

4. サーバーの起動

python core/zep_cloud_server.py

✨ 主な機能

• ユーザー管理：Zep Cloud 内のユーザーを作成、検索、更新、削除します。
• コレクション管理：メモリコレクションを作成および管理します。
• メモリ操作：メモリを追加、検索、探索します。
• 最新の実装：FastMCP 方法を使用して、より効率的で保守可能なサーバーを実現します。
• フォールバックモード：Zep Cloud API への接続ができない場合（認証エラー、ネットワーク問題など）、一部の機能のみをサポートするローカルモードに切り替わります。

📂 リポジトリ構造

このリポジトリは以下のディレクトリに整理されています。

• core/：コア機能ファイル

  • zep_cloud_client.py：Zep Cloud API のクライアント実装
  • zep_cloud_server.py：Claude Desktop ツールを提供する MCP サーバー
  • run_server.py：サーバーを直接実行する独立したスクリプト

• scripts/：操作ユーティリティスクリプト

  • check_user_exists.py：Zep Cloud 内にユーザーが存在するかどうかを確認します。
  • create_specific_user.py：Zep Cloud に特定のユーザーを作成するスクリプト
  • run_server.sh / run_server.bat：環境設定付きのサーバー実行用のシェルスクリプト
  • その他、様々なテストおよびデバッグ用のユーティリティスクリプト

• tests/：機能別に整理されたテストスクリプト

  • test_specific_user.py：すべてのユーザー操作の包括的なテスト
  • test_zep_cloud_client.py：Zep Cloud クライアントの単体テスト
  • test_comprehensive.py：すべての機能の完全な API テスト

• config/：設定ファイル

  • .env.example：環境設定テンプレート
  • .env.new：更新された環境設定
  • claude_desktop_config.json.example：Claude Desktop の設定テンプレート
  • requirements.txt：パッケージの依存関係

💻 使用例

ターミナルからのツールアクセス

• http://localhost:5000 にアクセスし、Zep Cloud API キーでログインします。
• 利用可能なツールを閲覧し、必要に応じて使用します。

Claude Desktop の設定

1. claude_desktop_config.json.example を claude_desktop_config.json にコピーします。

   cp claude_desktop_config.json.example claude_desktop_config.json
   

2. 設定ファイル内のパスと API キーを更新します。

   {
     "mcp_server_url": "http://localhost:5000",
     "api_key": "your_api_key_here"
   }
   

利用可能なツール

• ユーザー管理：create_user, get_user, update_user, delete_user, list_users
• コレクション管理：create_collection, get_collection, update_collection, delete_collection, list_collections
• メモリ操作：add_memory, get_memory, list_memories, search_memories

⚠️ セキュリティ上の注意事項

API キーの保護

• API キーをバージョン管理にコミットしないでください。.gitignore ファイルは .env ファイルを無視するように設定されています。
• 提供されている .env.example をテンプレートとして使用し、実際の API キーを使用して独自の .env ファイルを作成します。

設定ファイル

• claude_desktop_config.json などの個人設定ファイルにはシステム固有のパスが含まれているため、バージョン管理にコミットしないでください。
• 提供されている claude_desktop_config.json.example を参考にして、設定ファイルを作成および更新します。

🛠️ トラブルシューティング

トラブルシューティングに関する情報は、AUTHENTICATION_NOTE.md ドキュメントを参照してください。このドキュメントには、API 接続性と認証問題に関する詳細情報が含まれています。