AI导哈

Zep Cloud API服务器

Zep Cloud API服务器是一个上下文工程平台，用于AI代理记忆管理，支持知识图谱构建和内容分析。

  • by kev-hu
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 kev-hu/mcp-server-zep-cloud

使用说明

zep mcp

MCP服务器 Zep云 API-人工智能代理内存的上下文工程平台。内置于 FastMCP 和那个 zep云 Python SDK。

📖 故事

我最初在2025年初构建了这个项目，当时我刚刚学习如何编码。成功了！ .…技术上。旧版本有一个返回的回退客户端 虚假的成功反应 API关闭时😅, 每个可以想象的平台的包装脚本，以及足够多的冗余代码，让未来的我感到尴尬。

一年后，我学到了一两件事。所以我把它全部烧掉并重写了。

  • 之前： 2个纠结的客户端层，8个工具，欺骗你的回退模式，约4000行💀
  • 之后： 1个干净的服务器入口点，13个工具覆盖整个Zep Cloud API，约770行

保留旧的git历史，因为它有点有趣，lmao

用例

我将其用于我自己的内容——将视频脚本和观众评论摄入Zep的知识图中，以了解我所报道的内容、观众关心的内容以及我接下来应该做什么。

绘制您的内容知识图 --吸收你的剧本和观众评论。Zep自动提取主题、实体（例如人、团体、想法）以及它们之间的关系，涵盖您发布的所有内容。

查看哪些主题聚集在一起 --探索特定实体如何连接到内容片段和主题。蓝色节点是您的实际内容；周围的主题显示了这些视频中出现的主题以及评论者与该实体的关联。

查找内容差距 --查询具有许多主题和实体连接但没有链接内容节点的实体。这些是你的观众已经在思考和谈论的事情，而你还没有制作视频。

设置

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

复制 .env.example 到 .env 并填写您的Zep Cloud API密钥：

cp .env.example .env

安装预提交钩子以防止意外提交机密：

cp scripts/pre-commit .git/hooks/pre-commit

运行服务器

source venv/bin/activate
python server.py

或者使用FastMCP开发模式：

fastmcp dev server.py

配置

变量 必填 描述
ZEP_API_KEY 是 Zep Cloud API密钥
ZEP_TOOLSETS 无 要启用逗号分隔的工具组。价值观： memory, admin.默认为 memory,admin （所有工具）。

工具

按待完成工作组织的13个工具：

记忆工具 (memory):

  • add_messages --向对话线程添加消息
  • get_context --为用户获取已组装的上下文块
  • add_graph_data --将数据添加到知识图（文本、JSON、消息或三元组）
  • search_graph --在知识图中搜索事实、实体或事件
  • get_task --轮询异步Zep操作的状态

管理工具 (admin):

  • manage_user --用户CRUD（创建、获取、更新、删除、列表、热）
  • manage_user_instructions --管理用户摘要说明
  • manage_thread --线程CRUD（创建、获取、删除、列表）
  • manage_graph --图形生命周期（创建、获取、更新、删除、列表、克隆）
  • manage_graph_structure --图模式、本体和自定义指令
  • manage_graph_data --节点、边缘和事件检查和管理
  • manage_context_templates --上下文模板CRUD
  • project_info --获取当前Zep Cloud项目信息

运行测试

source venv/bin/activate
python -m pytest tests/

许可证

麻省理工学院

相关 MCP