Zep Cloud 的 MCP 服务器

Zep Cloud 的 MCP 服务器在 LLM 客户端和 Zep Cloud API 之间架起了一座桥梁，为 AI 助手提供了内存管理。

概述

一个 MCP 服务器，用于通过 Zep Cloud API 存储和检索用户记忆、偏好、操作流程和事实关系。它充当语义记忆层，使 AI 助手能够在对话中保留用户的上下文信息。

Related MCP server: Frinus MCP Server

工具

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

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

使用 Claude Desktop 手动安装

1. 克隆此存储库：

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

2. 安装依赖项：

pip install -r config/requirements.txt

3. 通过添加到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

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

# 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 或从 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 的客户端配合使用。它已通过以下测试：

• 克劳德桌面

• 克劳德在网页浏览器中

发展

运行测试

cd tests
python test_zep_cloud_client.py
python test_server_initialization_fixes.py

以开发模式运行

cd scripts
./run_server.sh

执照

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