Memory MCP Server

基本能力

产品定位

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）

curl -fsSL https://raw.githubusercontent.com/okooo5km/memory-mcp-server/main/install.sh | bash

选项2：从源代码构建

1. 克隆仓库：

git clone https://github.com/okooo5km/memory-mcp-server.git
cd memory-mcp-server

1. 构建项目：

swift build -c release

1. 安装二进制文件：

mkdir -p ~/.local/bin
cp $(swift build -c release --show-bin-path)/memory-mcp-server ~/.local/bin/

1. 添加到PATH：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # 或 ~/.bashrc
source ~/.zshrc  # 或 source ~/.bashrc

调试方式

# 显示帮助信息
memory-mcp-server --help

# 显示版本信息
memory-mcp-server --version

配置

设置自定义存储路径：

export MEMORY_FILE_PATH="/path/to/your/memory.json"

许可证

该项目遵循 MIT 开源许可条款。