Zep Cloud MCP 服务器

Zep Cloud MCP 服务器为 Claude Desktop 和 Zep Cloud API 提供了一个桥梁，实现 AI 助手的记忆管理。

仓库结构

该仓库已组织如下目录：

• 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：带有环境设置的运行服务器的 Shell 脚本
  • 多种其他测试和调试实用脚本

• 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：包依赖项

功能

• 用户管理：创建、检索、更新和删除 Zep Cloud 中的用户
• 集合管理：创建和管理记忆收藏集
• 记忆操作：添加、检索和搜索记忆
• 现代实现：使用 FastMCP 方法实现更高效和可维护的服务器
• 降回模式：如果无法连接到 Zep Cloud API（由于身份验证问题、网络问题等），将切换到本地模式，仅支持部分功能

安装与配置

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

使用说明

通过终端访问工具

• 访问 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 连接性和身份验证问题的详细信息。