MCP Server for Zep Cloud

MCP Server for Zep Cloud 提供了 LLM 客户端与 Zep Cloud API 之间的桥梁，使 AI 助手能够进行记忆管理。

概述

MCP 服务器通过 Zep Cloud API 存储和检索用户的记忆、偏好、程序和事实关系。它充当语义记忆层，使 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 的连接状态

环境变量

安装

使用 Smithery

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

通过 Claude Desktop 手动安装

1. 克隆此仓库：
   bash
   git clone https://github.com/yourusername/mcp-server-zep-cloud.git
   cd mcp-server-zep-cloud

2. 安装依赖项：
   bash
   pip install -r config/requirements.txt

3. 通过向 claude_desktop_config.json 添加配置来配置 Claude Desktop：
   json
   {
   "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%Claudeclaude_desktop_config.json

使用 Docker

提供了一个 Dockerfile 用于构建和运行 MCP 服务器：

bash

构建容器

docker build -t mcp-server-zep-cloud .

运行容器

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: 运行服务器的 Shell 脚本

• tests/: 测试脚本

  • test_zep_cloud_client.py: Zep Cloud 客户端的单元测试
  • test_server_initialization_fixes.py: 服务器初始化的测试

• config/: 配置文件

  • .env.example: 环境配置模板
  • requirements.txt: 包依赖

安全注意事项

• API 密钥保护: 不要将您的 API 密钥提交到版本控制系统
• 环境变量: 对于敏感数据，请使用环境变量
• 限制访问: 将服务器限制在受信任的网络中

支持其他客户端

该 MCP 服务器设计为可与任何兼容 MCP 的客户端一起工作。已测试支持以下客户端：

• Claude Desktop
• Claude 浏览器版

开发### 运行测试

bash
cd tests
python test_zep_cloud_client.py
python test_server_initialization_fixes.py

以开发模式运行

bash
cd scripts
./run_server.sh

许可证

此MCP服务器根据MIT许可证授权。