Knowledge Graph Memory Server

Knowledge Graph Memory Server

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

Overview

基本能力

产品定位

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

核心功能

  1. 实体管理
  2. 创建、删除实体
  3. 每个实体包含唯一名称、类型和观察列表
  4. 关系管理
  5. 创建、删除实体间的关系
  6. 关系以主动语态描述实体间的互动
  7. 观察管理
  8. 添加、删除实体相关的观察信息
  9. 观察信息应为原子性事实
  10. 查询功能
  11. 读取整个知识图谱
  12. 搜索节点
  13. 按名称检索特定节点

适用场景

  1. AI 助手的个性化聊天
  2. 用户信息管理
  3. 知识组织和检索
  4. 关系网络构建

工具列表

  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. 如何自定义存储路径?
  2. 通过设置 MEMORY_FILE_PATH 环境变量指定自定义 JSON 文件路径
  3. 如何处理重复实体?
  4. 创建实体时会自动忽略已存在的实体名称
  5. 删除操作是否具有级联效应?
  6. 删除实体时会级联删除其相关关系

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm
  2. 确保已安装 npx

安装教程

  1. 通过 npx 安装json { "mcpServers": { "memory": { "command": "npx", "args": [ "-y", "@mkusaka/mcp-server-memory" ] } } }
  2. 自定义设置json { "mcpServers": { "memory": { "command": "npx", "args": [ "-y", "@mkusaka/mcp-server-memory" ], "env": { "MEMORY_FILE_PATH": "/path/to/custom/memory.json" } } } }

调试方式

  1. 检查服务是否正常运行
  2. 使用 API 工具测试各项功能
  3. 检查内存文件是否正确更新
  4. 验证搜索和查询功能是否返回预期结果

许可证

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