mcp-server-zep-cloud

Zep Cloud 的 MCP 服务器

Zep Cloud 的 MCP 服务器在 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

使用 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

Dockerfile 可用于构建和运行 MCP 服务器：

回退模式

如果服务器无法连接到 Zep Cloud API，它会自动以回退模式启动：

• 所有API操作均模拟并返回成功
• 没有实际数据发送到 Zep Cloud API 或从 Zep Cloud API 接收
• 服务器保持运行，允许客户端集成运行
• 记录警告消息以指示回退模式

存储库结构

• core/ ：核心功能文件
  • zep_cloud_client.py ：Zep Cloud API 的客户端实现
  • zep_cloud_server.py ：MCP 服务器提供 API 访问工具
  • 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 的客户端配合使用。它已通过以下测试：

• 克劳德桌面
• 克劳德在网页浏览器中

发展

运行测试

以开发模式运行

执照

此 MCP 服务器根据 MIT 许可证获得许可。