Zep Poke MCP V2

Zep Poke MCP v2

🧠 一个安全的模型上下文协议（MCP）服务器，用于将Zep AI内存管理集成到AI应用程序中。

特性

• 内存管理：跨会话存储和检索对话记忆
• 语义搜索：使用自然语言搜索所有存储的记忆
• 会话跟踪：为不同的用户/会话维护单独的内存上下文
• 类型安全：使用TypeScript构建，实现稳健开发
• 安全：代码中没有API键，环境变量配置

先决条件

• Node.js>=18.0.0
• Zep Cloud API密钥(在这里买一个)

安装说明

1.克隆存储库

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

2.安装依赖项

npm install

3.配置环境变量

重要：创建一个 .env 根目录中使用Zep API密钥的文件：

ZEPAPIKEY=your_zep_api_key_here

⚠️ 安全说明：永远不要承诺你的 .env 文件或API密钥。这 .gitignore 文件已配置为排除敏感文件。

4.建设项目

npm run build

5.运行MCP服务器

开发模式 （热重新加载）：

npm run dev

生产模式:

npm start

可用工具

此MCP服务器提供三个主要工具：

1. create_memory

将消息存储在用户会话的内存中。

参数：

• sessionId （string）：会话的唯一标识符
• message （string）：要存储的消息内容
• role （“用户”|“助理”）：谁发送了消息

2. get_memory

检索特定会话的所有记忆。

参数：

• sessionId （string）：用于检索内存的会话标识符

3. search_memory

使用语义搜索在所有记忆中搜索。

参数：

• query （string）：自然语言搜索查询
• limit （数字，可选）：最大结果数（默认值：10）

用法示例

MCP服务器运行后，您可以将其连接到MCP兼容的客户端，如Claude Desktop或其他AI应用程序。

Claude桌面配置

添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "zep-poke": {
      "command": "node",
      "args": ["/path/to/zep-poke-mcp-v2/dist/index.js"],
      "env": {
        "ZEPAPIKEY": "your_zep_api_key_here"
      }
    }
  }
}

项目结构

zep-poke-mcp-v2/
├── src/
│   ├── index.ts       # MCP server entry point
│   └── zepai.ts       # Zep AI integration logic
├── dist/              # Compiled JavaScript (generated)
├── .env               # Environment variables (create this yourself)
├── .gitignore         # Git ignore rules
├── package.json       # Project dependencies
├── tsconfig.json      # TypeScript configuration
├── vercel.json        # Vercel deployment config
└── README.md          # This file

部署

维塞尔

1. 安装Vercel CLI： npm i -g vercel
2. 在Vercel中将您的Zep API密钥添加为环境变量：

   vercel env add ZEPAPIKEY

1. 部署：

   vercel

备注：记得添加 ZEPAPIKEY 作为Vercel项目设置中的秘密环境变量。

安全最佳实践

✅ 做：

• 将API密钥存储在环境变量中
• 使用 .env 本地开发文件
• 保持 .env 在 .gitignore
• 在生产中使用环境机密（例如Vercel机密）

❌ 不要：

• 将API密钥提交到版本控制
• 分享你的 .env 文件
• 源代码中的硬编码敏感凭据

发展

类型检查

npm run type-check

建筑

npm run build

故障排除

“ZEPAPIKEY环境变量是必需的”错误

• 确保您已创建 .env 项目根目录中的文件
• 验证 .env 文件包含： ZEPAPIKEY=your_actual_api_key
• 确保周围没有空格 = 标志

未找到模块错误

• 跑 npm install 确保所有依赖项都已安装
• 跑 npm run build 将TypeScript编译为JavaScript

贡献

欢迎投稿！请随时提交拉取请求。

许可证

麻省理工学院

资源

• Zep文档
• 模型上下文协议
• MCP-SDK

作者

丹妮拉 可能

______________________________________________________________________

内置于❤️ 对于MCP社区