
Knowledge Graph Memory Server

2025.03.30
0
JavaScript知识图谱记忆服务个性化聊天开发效率
mcp-memory-server 是一个基于本地知识图谱的持久化记忆服务,旨在帮助 Claude 等AI模型跨聊天会话记住用户信息。该服务通过实体、关系和观察三个核心概念构建知识图谱,支持创建、查询、更新和删除操作,适用于个性化聊天、信息记忆和关系管理等多种场景。
View on GitHub
Overview
基本能力
产品定位
mcp-memory-server 是一个基于本地知识图谱的持久化记忆服务,旨在帮助AI模型跨聊天会话记住用户信息。
核心功能
- 实体管理:创建、删除和查询实体,每个实体包含唯一名称、类型和观察列表。
- 关系管理:定义和管理实体之间的有向关系。
- 观察管理:添加、删除和查询实体的观察信息。
- 知识图谱查询:支持全文搜索和特定节点查询。
适用场景
- 个性化聊天:记住用户的偏好、习惯和个人信息。
- 信息记忆:存储和检索用户提供的关键信息。
- 关系管理:管理用户与其他实体(如组织、事件)的关系。
工具列表
- create_entities:创建新实体。
- create_relations:创建实体间的关系。
- add_observations:向实体添加观察信息。
- delete_entities:删除实体及其关联关系。
- delete_observations:删除实体的观察信息。
- delete_relations:删除实体间的关系。
- read_graph:读取整个知识图谱。
- search_nodes:基于查询搜索节点。
- open_nodes:按名称检索特定节点。
常见问题解答
- 如何配置存储路径:通过环境变量
MEMORY_FILE_PATH
设置自定义存储路径。 - 如何处理重复实体:
create_entities
会忽略已存在的实体。 - 如何处理不存在的实体:相关操作会静默跳过或失败(如
add_observations
)。
使用教程
使用依赖
- 确保已安装 Docker 或 Node.js(包括 npm/npx)。
安装教程
Docker
docker build -t mcp/memory -f src/Dockerfile .
NPX
npx mcp-memory-server
NPX with custom setting
npx mcp-memory-server --env MEMORY_FILE_PATH=/path/to/custom/memory.json
调试方式
- 验证服务运行:检查 Docker 容器或 Node.js 进程是否正常运行。
- 测试API:使用
read_graph
工具验证知识图谱是否可访问。 - 检查日志:查看服务日志以排查错误。