zep-mcp
MCP server for the Zep Cloud API — a context engineering platform for AI agent memory. Built with FastMCP and the zep-cloud Python SDK.
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
I originally built this project back in early 2025 when I was just learning how to code. It worked! ...technically. The old version had a fallback client that returned fake success responses when the API was down 😅, wrapper scripts for every platform imaginable, and enough redundant code to make future-me cringe.
A year later, I've learned a thing or two. So I burned it all down and rewrote it.
- Before: 2 tangled client layers, 8 tools, fallback mode that lied to you, ~4,000 lines 💀
- After: 1 clean server entry point, 13 tools covering the full Zep Cloud API, ~770 lines
Keeping the old git history because it's kinda funny lmao
I use this for my own content — ingesting video scripts and viewer comments into Zep's knowledge graph to understand what I've covered, what my audience cares about, and what I should make next.
Map your content knowledge graph — ingest your scripts and audience comments. Zep auto-extracts topics, entities (e.g. people, groups, ideas), and the relationships between them across everything you've published.

See what topics cluster together — explore how a specific entity connects to content pieces and topics. Blue nodes are your actual content; the surrounding topics show what themes appear across those videos and what commenters associate with that entity.

Find content gaps — query for entities with many topic and entity connections but no linked content nodes. Those are things your audience is already thinking and talking about that you haven't made a video on yet.

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
Copy .env.example to .env and fill in your Zep Cloud API key:
cp .env.example .env
Install the pre-commit hook to prevent accidentally committing secrets:
cp scripts/pre-commit .git/hooks/pre-commit
source venv/bin/activate
python server.py
Or with FastMCP dev mode:
fastmcp dev server.py
13 tools organized by jobs-to-be-done:
Memory tools (memory):
add_messages — Add messages to a conversation threadget_context — Get assembled context block for a useradd_graph_data — Add data to a knowledge graph (text, JSON, message, or triple)search_graph — Search a knowledge graph for facts, entities, or episodesget_task — Poll status of an async Zep operationAdmin tools (admin):
manage_user — User CRUD (create, get, update, delete, list, warm)manage_user_instructions — Manage user summary instructionsmanage_thread — Thread CRUD (create, get, delete, list)manage_graph — Graph lifecycle (create, get, update, delete, list, clone)manage_graph_structure — Graph schema, ontology, and custom instructionsmanage_graph_data — Node, edge, and episode inspection and managementmanage_context_templates — Context template CRUDproject_info — Get current Zep Cloud project infosource venv/bin/activate
python -m pytest tests/
MIT
MCP server for the Zep Cloud API — knowledge graph memory for AI agents
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Zep 通过 stdio 在本地运行。
上次检查时间:2026-10-28。 MCP server for the Zep Cloud API — knowledge graph memory for AI agents