Zanny 的持久内存管理器
一个自定义的 MCP(模型功能提供程序)服务器,可用作持久内存库。这款基于 TypeScript 的服务器允许您通过灵活的关键字检测和命令来存储、检索和管理内存。
特征
- 存储记忆:保存任何基于文本的信息以供日后检索
- 检索记忆:通过内容或ID搜索并检索存储的记忆
- 删除记忆:删除不再需要的记忆
- 智能关键词检测:自动检测自然语言中的相关命令
- 无限存储:内存存储大小不受人为限制
- 全面的日志记录:用于故障排除和监控的详细日志记录
- MCP 兼容性:Smithery.ai 部署的完整 JSON-RPC 实现
安装
- 确保你的系统上安装了 Node.js 和 npm
- 安装项目依赖项:
- 构建 TypeScript 项目:
用法
启动服务器
使用以下命令启动服务器:
默认情况下,服务器将开始监听端口 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 规范兼容。
执照
国际学习中心