Knowledge Graph Memory Server

Knowledge Graph Memory Server

site icon
2025.03.30 0
JavaScript知识图谱记忆服务个性化聊天开发效率
mcp-memory-server 是一个基于本地知识图谱的持久化记忆服务,旨在帮助 Claude 等AI模型跨聊天会话记住用户信息。该服务通过实体、关系和观察三个核心概念构建知识图谱,支持创建、查询、更新和删除操作,适用于个性化聊天、信息记忆和关系管理等多种场景。
View on GitHub

Overview

基本能力

产品定位

mcp-memory-server 是一个基于本地知识图谱的持久化记忆服务,旨在帮助AI模型跨聊天会话记住用户信息。

核心功能

  1. 实体管理:创建、删除和查询实体,每个实体包含唯一名称、类型和观察列表。
  2. 关系管理:定义和管理实体之间的有向关系。
  3. 观察管理:添加、删除和查询实体的观察信息。
  4. 知识图谱查询:支持全文搜索和特定节点查询。

适用场景

  1. 个性化聊天:记住用户的偏好、习惯和个人信息。
  2. 信息记忆:存储和检索用户提供的关键信息。
  3. 关系管理:管理用户与其他实体(如组织、事件)的关系。

工具列表

  1. create_entities:创建新实体。
  2. create_relations:创建实体间的关系。
  3. add_observations:向实体添加观察信息。
  4. delete_entities:删除实体及其关联关系。
  5. delete_observations:删除实体的观察信息。
  6. delete_relations:删除实体间的关系。
  7. read_graph:读取整个知识图谱。
  8. search_nodes:基于查询搜索节点。
  9. open_nodes:按名称检索特定节点。

常见问题解答

  1. 如何配置存储路径:通过环境变量 MEMORY_FILE_PATH 设置自定义存储路径。
  2. 如何处理重复实体create_entities 会忽略已存在的实体。
  3. 如何处理不存在的实体:相关操作会静默跳过或失败(如 add_observations)。

使用教程

使用依赖

  1. 确保已安装 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

调试方式

  1. 验证服务运行:检查 Docker 容器或 Node.js 进程是否正常运行。
  2. 测试API:使用 read_graph 工具验证知识图谱是否可访问。
  3. 检查日志:查看服务日志以排查错误。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。