Zanny 的持久内存管理器

一个自定义的 MCP (模型能力提供者) 服务器，用作持久内存库。 这个基于 TypeScript 的服务器允许您存储、检索和管理具有灵活的关键词检测和命令的记忆。

特性

• 存储记忆: 保存任何基于文本的信息，以便以后检索
• 检索记忆: 通过内容或 ID 搜索和检索存储的记忆
• 删除记忆: 删除不再需要的记忆
• 智能关键词检测: 自动检测自然语言中的相关命令
• 无限存储: 对内存存储大小没有人为限制
• 全面日志记录: 详细的日志记录，用于故障排除和监控
• MCP 兼容性: 完整的 JSON-RPC 实现，用于 Smithery.ai 部署

安装

1. 确保您的系统上已安装 Node.js 和 npm
2. 安装项目依赖项:

   npm install
   

3. 构建 TypeScript 项目:

   npm run build
   

使用

启动服务器

使用以下命令启动服务器:

npm start

服务器默认将在端口 3000 上开始监听。

API 端点

REST API (旧版)

• GET /health - 检查服务器健康状况
• POST /api/memories - 存储新的记忆
• GET /api/memories - 列出或搜索记忆
• GET /api/memories/:id - 检索特定的记忆
• DELETE /api/memories/:id - 删除记忆
• POST /api/detect - 检测文本中的触发关键词

JSON-RPC 端点 (MCP 兼容)

• POST /tools/list - 列出可用的工具
• POST /tools/call - 调用特定的工具

记忆命令

MCP 服务器理解与记忆管理相关的自然语言命令。 示例:

存储记忆

remember: 这是我想存储的重要信息
store: 会议安排在 3 月 15 日下午 2 点

检索记忆

recall information about meetings
remember anything related to schedules

删除记忆

delete memory with id 5f4dcc3b5aa765d61d8327deb882cf99
forget id 5f4dcc3b5aa765d61d8327deb882cf99

列出所有记忆

list all memories
show all memories

项目结构

├── dist/                # 编译后的 JavaScript 输出
├── logs/                # 日志文件
├── src/                 # TypeScript 源代码
│   ├── config.ts        # 服务器配置
│   ├── index.ts         # 入口点
│   ├── logger.ts        # 日志记录配置
│   ├── mcpServer.ts     # 主要 MCP 服务器实现
│   └── memoryManager.ts # 内存存储和检索
├── package.json         # 项目依赖项
├── smithery.json        # Smithery.ai 配置
├── tsconfig.json        # TypeScript 配置
└── README.md            # 此文件

配置

配置在 src/config.ts 中管理。 主要设置包括:

• 服务器名称
• 服务器端口
• 记忆目录
• 日志记录器配置
• 触发关键词

部署到 Smithery.ai

此 MCP 服务器与 Smithery.ai 部署兼容。 要部署:

1. 确保您的代码位于 Git 存储库中
2. 如果您没有 Smithery.ai 帐户，请创建一个
3. 将您的存储库连接到 Smithery.ai
4. 包含的 smithery.json 文件将指导部署过程

日志记录

日志存储在 logs/ 目录中。 所有日志都格式化为 JSON，以确保与 MCP 规范兼容。

许可证

ISC