MCP Server for Zep Cloud

MCP Server for Zep Cloud

site icon
2025.04.04 2
PythonAI助手内存管理开发效率
MCP Server for Zep Cloud 是一个连接 Claude Desktop 和 Zep Cloud API 的桥梁,主要用于 AI 助手的内存管理。它提供了用户管理、集合管理、内存操作等功能,并支持现代 FastMCP 实现以提高效率和可维护性。此外,当 Zep Cloud API 不可访问时,服务会自动进入回退模式,保证基本功能的可用性。
View on GitHub

Overview

基本能力

产品定位

MCP Server for Zep Cloud 是一个中间件服务,旨在为 Claude Desktop 提供与 Zep Cloud API 的连接能力,专注于 AI 助手的内存管理功能。

核心功能

  • 用户管理:创建、检索、更新和删除 Zep Cloud 中的用户
  • 集合管理:创建和管理内存集合
  • 内存操作:添加、检索和搜索内存
  • 现代实现:采用 FastMCP 方法,提高效率和可维护性
  • 回退模式:当 Zep Cloud API 不可访问时自动切换到回退模式

适用场景

  • 在 Claude Desktop 中集成 Zep Cloud 的内存管理功能
  • 开发需要持久化记忆功能的 AI 助手应用
  • 需要灵活管理用户和内存集合的 AI 应用场景

工具列表

  1. 用户管理工具
  2. create_user: 创建新用户
  3. get_user: 获取用户详情
  4. update_user: 更新用户元数据
  5. delete_user: 删除用户
  6. list_users: 列出所有用户

  7. 集合管理工具

  8. create_collection: 创建新集合
  9. get_collection: 获取集合详情
  10. update_collection: 更新集合元数据
  11. delete_collection: 删除集合
  12. list_collections: 列出所有集合

  13. 内存操作工具

  14. add_memory: 为用户向集合添加内存
  15. get_memory: 从集合中获取用户内存
  16. list_memories: 列出集合中的用户内存
  17. search_memories: 搜索集合中的用户内存

  18. 连接性工具

  19. check_connection: 检查与 Zep Cloud API 的连接状态

常见问题解答

  • 服务无法连接 Zep Cloud API 时会自动进入回退模式
  • 配置 Claude Desktop 时需要使用绝对路径
  • API 密钥保护至关重要,不应提交到版本控制

使用教程

使用依赖

  • Python 3.8+
  • Zep Cloud API key

安装教程

  1. 克隆仓库:
git clone https://github.com/yourusername/mcp-server-zep-cloud.git
cd mcp-server-zep-cloud
  1. 创建并激活虚拟环境:
# macOS/Linux
python -m venv venv
source venv/bin/activate

# Windows
python -m venv venv
venv\Scripts\activate
  1. 安装依赖包:
pip install -r config/requirements.txt
  1. 配置环境变量:
cp config/.env.example .env

编辑 .env 文件添加 Zep Cloud API 密钥:

ZEP_API_KEY=your_api_key_here

调试方式

  1. 启动服务:
# macOS/Linux
cd scripts
./run_server.sh

# Windows
cd scripts
run_server.bat
  1. 测试 API 连接:
cd scripts
python check_user_exists.py [user_id]
  1. 创建特定用户:
cd scripts
python create_specific_user.py

许可证

None