Mcp Server Zep Cloud

AI 官方认证 Python

🚀 Zep Cloud MCP 服务器

Zep Cloud MCP 服务器搭建了 Claude Desktop 与 Zep Cloud API 之间的桥梁，实现了对 AI 助手记忆的有效管理。

🚀 快速开始

安装与配置

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

复制 claude_desktop_config.json.example 到 claude_desktop_config.json：
```
cp claude_desktop_config.json.example claude_desktop_config.json
```

更新配置文件中的路径和 API 密钥：

{
"mcp_server_url": "http://localhost:5000",
"api_key": "your_api_key_here"
}

✨ 主要特性

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

📦 安装指南

克隆仓库

git clone [your-repository-url]
cd mcp-server

创建并激活虚拟环境（推荐）

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt

配置环境变量

复制 .env.example 到 .env 并添加你的 API 密钥：
```
cp .env.example .env
nano .env
```
更新以下内容：
```
ZEPCLOUD_API_KEY=your_api_key_here
```

启动服务器

python core/zep_cloud_server.py

💻 使用示例

可用工具

用户管理：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

📚 详细文档

仓库结构

该仓库已组织如下目录：

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

🔧 技术细节

现代实现

使用 FastMCP 方法实现更高效和可维护的服务器。

降回模式

如果无法连接到 Zep Cloud API（由于身份验证问题、网络问题等），将切换到本地模式，仅支持部分功能。

⚠️ 重要提示

API 密钥保护

绝不要将 API 密钥提交到版本控制。.gitignore 文件配置为忽略 .env 文件。
使用提供的 .env.example 作为模板，并使用实际 API 密钥创建自己的 .env 文件。

配置文件

个人配置文件如 claude_desktop_config.json 包含系统特定路径，不应提交到版本控制中。
使用提供的 claude_desktop_config.json.example 作为参考来创建和更新配置文件。

📄 故障排除

有关故障排除信息，请参阅 AUTHENTICATION_NOTE.md 文档，其中包含关于 API 连接性和身份验证问题的详细信息。

0 条评论
分类：AI