article
README
🚀 自定义内存服务 : PouchDB 🧠
此项目为MCP团队提供的Memory服务器增添了新功能,允许创建和管理知识图谱,还能捕捉通过语言模型(LLM)进行的交互,实用性和趣味性兼具,就像给服务器装上了一个智能“大脑”,让其能更好地处理和存储信息。🚀
该项目是从https://github.com/BRO3886/mcp-memory-custom fork而来,特别感谢原项目修复了时间戳问题。此仓库的主要目标是解决上下文不断增长的JSON文件问题,让数据管理更加高效。
✨ 主要特性
1. PouchDB 集成 💾
- 现在服务器采用PouchDB进行稳健的文档存储。
- 优势:数据一致性更好,具备内置版本控制,且在处理大型数据集时性能显著提升。
- 同时维持文件备份以保持兼容性。
2. 自定义内存文件路径 📁
- 支持自定义内存文件路径。
- 好处:提供更大的灵活性,可适应不同的存储需求。
3. 错误恢复 ✨
- 增强了错误处理机制,使服务器运行更加稳定。
- 意义:确保在面对错误时能够快速恢复,保持服务的可用性。
🚀 快速开始
先决条件 🛠️
- 需安装Node.js 和 npm。
- 熟悉命令行操作。
📦 安装指南
- 克隆仓库:
git clone https://github.com/yourusername/mcp-memory-pouchdb.git
cd mcp-memory-pouchdb
- 安装依赖:
npm install
配置说明 🛡️
- 设置环境变量:
export MEMORY_FILE_PATH=/path/to/your/memoryfile.json - 初始化数据库:
npm run init-db
运行服务器 💽
- 构建项目:
npm run build
- 启动服务:
node dist/index.js
核心工具 🔧
- 获取当前时间 ⏰
- 设置内存文件路径 📁
- 创建实体 ➕
- 创建关系 🔗
- 添加观察 📝
- 删除实体 ❌
- 删除观察 🗑️
- 删除关系 🔗
- 读取图谱 📖
- 搜索节点 🔍
- 打开节点 🔓
💡 重要说明
- 所有操作均严格遵循用户隐私和数据保护政策。
- 数据持久化通过PouchDB实现,确保了数据的安全性和可靠性。
💻 使用示例
基础用法
// 创建实体
createEntity({
id: 'user123',
properties: {
name: '张三',
age: 28,
role: '开发者'
}
});
// 建立关系
createRelation({
from: 'user123',
to: 'project456',
type: '参与'
});
// 添加观察
addObservation({
entityId: 'project456',
content: '项目预计在下个月完成',
timestamp: getCurrentTime()
});
🙏 致谢
- 感谢Anthropic的Memory服务器带来的启发。
- 感谢PouchDB提供强大的数据存储支持 💾
Scan to contact