AI导哈

AI对话管理服务器

一个生产就绪的模型上下文协议（MCP）服务器，用于将Zep AI的记忆和对话管理功能集成到AI应用中。

  • by Dpdpdpdp0987
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Dpdpdpdp0987/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 AI

相关 MCP