基本能力
产品定位
Memory MCP Server 是一个知识图谱管理服务,旨在为AI助手提供长期记忆能力,帮助它们记住用户偏好、过去交互和重要事实。
核心功能
- 知识图谱存储:维护实体及其关系的持久化图谱
- 实体管理:创建、检索、更新和删除具有自定义类型的实体
- 关系跟踪:定义和管理实体之间的关系(使用主动语态)
- 观察系统:随时间添加和删除关于实体的观察
- 强大搜索:通过名称、类型或观察内容查找相关节点
- 持久存储:数据以简单的JSON格式在会话之间保持
适用场景
- AI助手的长期记忆
- 知识管理(人员、地点、事件和概念)
- 关系跟踪
- 跨会话的上下文保持
- 日志和日常记录
工具列表
create_entities
- 在知识图谱中创建多个新实体create_relations
- 在实体之间创建多个新关系add_observations
- 向现有实体添加新观察delete_entities
- 删除多个实体及其关联关系delete_observations
- 从实体中删除特定观察delete_relations
- 从知识图谱中删除多个关系read_graph
- 读取整个知识图谱search_nodes
- 基于查询搜索知识图谱中的节点open_nodes
- 按名称打开特定节点
常见问题解答
- 数据存储位置:默认在当前工作目录的memory.json文件中,可通过MEMORY_FILE_PATH环境变量自定义
- 平台要求:需要Swift 6.0或更高版本,macOS 14.0或更高版本
使用教程
使用依赖
- Swift 6.0或更高版本
- macOS 14.0或更高版本
- MCP Swift SDK 0.2.0或更高版本
安装教程
选项1:单行安装(curl)
bash
curl -fsSL https://raw.githubusercontent.com/okooo5km/memory-mcp-server/main/install.sh | bash
选项2:从源代码构建
- 克隆仓库:
bash
git clone https://github.com/okooo5km/memory-mcp-server.git
cd memory-mcp-server - 构建项目:
bash
swift build -c release - 安装二进制文件:
bash
mkdir -p ~/.local/bin
cp $(swift build -c release --show-bin-path)/memory-mcp-server ~/.local/bin/ - 添加到PATH:
bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # 或 ~/.bashrc
source ~/.zshrc # 或 source ~/.bashrc
调试方式
```bash
显示帮助信息
memory-mcp-server --help
显示版本信息
memory-mcp-server --version
```
配置
设置自定义存储路径:
bash
export MEMORY_FILE_PATH="/path/to/your/memory.json"