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: This is important information I want to store
store: The meeting is scheduled for March 15th at 2pm

检索记忆

recall information about meetings
remember anything related to schedules

删除记忆

delete memory with id 5f4dcc3b5aa765d61d8327deb882cf99
forget id 5f4dcc3b5aa765d61d8327deb882cf99

列出所有记忆

list all memories
show all memories

项目结构

├── dist/                # Compiled JavaScript output
├── logs/                # Log files
├── src/                 # TypeScript source code
│   ├── config.ts        # Server configuration
│   ├── index.ts         # Entry point
│   ├── logger.ts        # Logging configuration
│   ├── mcpServer.ts     # Main MCP server implementation
│   └── memoryManager.ts # Memory storage and retrieval
├── package.json         # Project dependencies
├── smithery.json        # Smithery.ai configuration
├── tsconfig.json        # TypeScript configuration
└── README.md            # This file

配置

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

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

部署到 Smithery.ai

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

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

日志

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

许可证

ISC