Zep Cloud用MCPサーバー

鍛冶屋のバッジ

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

概要

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

Related MCP server: mcp-server-cloudbrowser

ツール

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

環境変数

名前	説明	デフォルト値
`ZEP_API_KEY`	Zep CloudサービスのAPIキー	なし
`MCP_HOST`	サーバーをバインドするホスト	`0.0.0.0`
`MCP_PORT`	サーバーを実行するポート	`8080`

インストール

鍛冶屋を使う

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

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

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

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

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

pip install -r config/requirements.txt

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

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

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

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

Dockerの使用

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

# 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

フォールバックモード

サーバーが 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互換のあらゆるクライアントで動作するように設計されています。以下の環境でテスト済みです。

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

発達

テストの実行

cd tests python test_zep_cloud_client.py python test_server_initialization_fixes.py

開発モードで実行

cd scripts ./run_server.sh

ライセンス

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

mcp-server-zep-cloud