Zep Poke MCP

Zep Poke MCP服务器

  

用于集成的生产就绪模型上下文协议（MCP）服务器 Zep AI 将内存和对话管理集成到AI应用程序中。专为与Poke和其他MCP兼容的客户端一起使用而构建。

特性

✨ 完整的Zep集成

• 🔍 语义会话搜索
• 💾 上下文和消息存储
• 📜 对话历史检索
• 🧠 自动事实提取
• 📊 内存会话管理
• 🆕 会话创建和初始化

🚀 生产就绪

• 具有完全类型安全的TypeScript
• 错误处理和验证
• Vercel部署支持
• 环境变量配置
• 干净、可维护的代码结构

快速开始

先决条件

• Node.js 18+
• Zep API密钥（在 getzep.com)
• npm、yarn或pnpm

安装

1. 克隆存储库

git clone https://github.com/Dpdpdpdp0987/zep-poke-mcp.git
cd zep-poke-mcp

1. 安装依赖项

npm install
# or
yarn install
# or
pnpm install

1. 配置环境变量

cp .env.example .env

编辑 .env 并添加您的Zep API密钥：

ZEP_API_KEY=your_zep_api_key_here
ZEP_API_URL=https://api.getzep.com

1. 构建项目

npm run build

1. 运行服务器

npm start

MCP工具

该服务器为Zep AI集成提供了6个强大的工具：

1. search_conversations

使用语义搜索搜索对话。

参数：

• query （必填）：搜索查询文本
• sessionId （可选）：将搜索限制到特定会话
• limit （可选）：最大结果（默认值：10）

例子：

{
  "query": "What did we discuss about project deadlines?",
  "limit": 5
}

2. store_context

在Zep中存储对话消息。

参数：

• sessionId （必需）：唯一会话标识符
• role （必填）：“用户”、“助理”或“系统”
• content （必填）：消息内容
• metadata （可选）：附加元数据对象

例子：

{
  "sessionId": "user-123-session",
  "role": "user",
  "content": "I need help with the dashboard feature",
  "metadata": { "priority": "high" }
}

3. retrieve_history

获取会话的对话历史记录。

参数：

• sessionId （必填）：要检索的会话
• limit （可选）：最大消息数（默认值：20）

例子：

{
  "sessionId": "user-123-session",
  "limit": 10
}

4. extract_facts

从对话中提取Zep自动识别的事实。

参数：

• sessionId （必填）：从中提取事实的会议

例子：

{
  "sessionId": "user-123-session"
}

5. list_memories

列出所有会话记忆。

参数：

• limit （可选）：要返回的最大会话数（默认值：50）

例子：

{
  "limit": 25
}

6. create_memory

创建新的会话内存。

参数：

• sessionId （必需）：唯一会话标识符
• metadata （可选）：会话元数据

例子：

{
  "sessionId": "new-user-456",
  "metadata": { "userId": "456", "name": "Alice" }
}

Poke的配置

将此添加到您的Poke MCP配置中：

{
  "mcpServers": {
    "zep": {
      "command": "node",
      "args": ["/path/to/zep-poke-mcp/dist/index.js"],
      "env": {
        "ZEP_API_KEY": "your_zep_api_key_here",
        "ZEP_API_URL": "https://api.getzep.com"
      }
    }
  }
}

Vercel部署

选项1：使用Vercel CLI进行部署

1. 安装Vercel命令行界面

npm install -g vercel

1. 登录Vercel

vercel login

1. 部署

vercel

1. 在Vercel仪表板中设置环境变量

• 转到项目设置
• 添加 ZEP_API_KEY 秘密
• 可选择添加 ZEP_API_URL

选项2：通过GitHub部署

1. 将此存储库推送到GitHub
2. 导入项目 Vercel仪表板
3. 配置环境变量
4. 部署！

发展

项目结构

zep-poke-mcp/
├── src/
│   ├── index.ts        # Main MCP server implementation
│   └── zepai.ts        # Zep API client wrapper
├── dist/               # Compiled JavaScript (generated)
├── package.json        # Dependencies and scripts
├── tsconfig.json       # TypeScript configuration
├── vercel.json         # Vercel deployment config
├── .env.example        # Environment variables template
├── .gitignore          # Git ignore rules
└── README.md           # This file

开发命令

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server
npm start

# Lint code
npm run lint

建筑

此MCP服务器遵循最佳实践：

1. TypeScript优先：完全类型安全和IntelliSense支持
2. 模块化设计：单独关注点（MCP服务器、Zep客户端、类型）
3. 错误处理：全面的错误处理和验证
4. 环境配置：安全的凭据管理
5. 生产就绪：针对部署和扩展进行了优化

Zep AI集成

该服务器集成了Zep AI的强大功能：

• 持久存储器：存储和检索对话上下文
• 语义搜索：在所有对话中查找相关信息
• 事实提取：自动识别和存储关键事实
• 会话管理：按会话组织对话
• 元数据支持：将自定义元数据附加到消息和会话

了解更多信息，请访问 Zep文档

故障排除

“ZEP_API_KEY环境变量是必需的”

• 确保您已创建 .env 使用API密钥文件
• 验证API密钥是否正确

“搜索/存储/检索失败”

• 检查您的Zep API密钥是否有效
• 验证您的Zep API URL是否正确
• 确保您有网络连接
• 检查Zep服务状态

构建错误

• 删除 node_modules 和 dist 文件夹
• 跑 npm install 再次
• 跑 npm run build

贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

支持

• 问题:
• Zep文档: docs.getzep.com
• MCP文件: 模型上下文协议.io

作者

丹妮拉 可能

______________________________________________________________________

内置于❤️ 使用模型上下文协议和Zep AI