Zanny 的持久内存管理器

一个自定义的 MCP（模型功能提供程序）服务器，可用作持久内存库。这款基于 TypeScript 的服务器允许您通过灵活的关键字检测和命令来存储、检索和管理内存。

特征

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

安装

确保你的系统上安装了 Node.js 和 npm
安装项目依赖项：
npm install
构建 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 部署兼容。部署方法如下：

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

日志记录

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

执照

国际学习中心

Zanny's Persistent Memory Manager

Integrations