MIT License
Zep Cloud 的 MCP 服务器
Zep Cloud 的 MCP 服务器在 LLM 客户端和 Zep Cloud API 之间架起了一座桥梁，为 AI 助手提供了内存管理。
概述
一个 MCP 服务器，用于通过 Zep Cloud API 存储和检索用户记忆、偏好、操作流程和事实关系。它充当语义记忆层，使 AI 助手能够在对话中保留用户的上下文信息。
工具
用户管理：
create_user：在 Zep Cloud 中创建新用户get_user：获取用户的详细信息update_user：更新用户的元数据delete_user：删除用户list_users：列出所有用户
图形操作：
search_graph：搜索用户的记忆图add_graph_data：向用户的内存图添加数据
连接性：
check_connection：使用 Zep Cloud API 检查连接状态
环境变量
姓名 | 描述 | 默认值 |
| Zep Cloud 服务的 API 密钥 | 没有任何 |
| 绑定服务器的主机 |
|
| 运行服务器的端口 |
|
安装
使用 Smithery
npx @smithery/cli install mcp-server-zep-cloud --client claude
使用 Claude Desktop 手动安装
克隆此存储库：
git clone https://github.com/yourusername/mcp-server-zep-cloud.git
cd mcp-server-zep-cloud
安装依赖项：
pip install -r config/requirements.txt
通过添加到
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.jsonWindows：
%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 许可证获得许可。
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
mcp-服务器-zep-cloud
Related MCP Servers
- MIT License
- MIT License