Zep MCP Server

Zep MCP服务器

简单的MCP服务器，包装Zep Cloud API（v3）与Claude Code一起使用。

使Claude Code能够使用Zep的基于线程的内存系统存储和检索内存。

安装

git clone https://github.com/yourusername/zep-mcp-server.git
cd zep-mcp-server
npm install
npm run build

配置

添加到您的 ~/.claude.json:

{
  "mcpServers": {
    "zep": {
      "command": "node",
      "args": ["/absolute/path/to/zep-mcp-server/dist/index.js"],
      "env": {
        "ZEP_API_KEY": "z_your_zep_api_key"
      }
    }
  }
}

从获取您的Zep API密钥https://www.getzep.com

用法

Claude Code提供三种工具：

zep_商店_记忆

将信息存储在Zep会话中。

zep_search_memory

在Zep会话中搜索信息。

zep_get_存储器

通过分页和过滤支持从会话中获取最近的记忆。

参数：

• session_id （必需）：要检索的线程/会话ID
• lastn （可选）：要返回的最新消息数（例如，50、100、200）
• limit （可选）：限制返回的结果数量（替代lastn）
• cursor （可选）：分页光标（与限制一起使用）
• role_filter （可选）：按消息角色筛选：“用户”、“助理”或“系统”

示例：

# Get last 50 messages from a large session
zep_get_memory(session_id="esme", lastn=50)

# Get only assistant messages
zep_get_memory(session_id="esme", lastn=100, role_filter="assistant")

# Use cursor-based pagination
zep_get_memory(session_id="esme", limit=50, cursor=0)

线程/会话命名约定

• 全球知识： global
• 项目具体： project-{name}
• 用户特定： user-{username}

注意：此服务器使用Zep Cloud v3 API，它使用“线程”而不是“会话”。工具仍然可以接受 session_id 为了向后兼容性。

示例

Store in session 'global':
Title: Building Multi-Agent Systems
Content: [article content]

许可证

麻省理工学院