MCP Memory Server

🚀 知识图谱内存服务器

本项目是一个基本的知识图谱持久化内存实现，借助本地知识图谱，让Claude能够记住用户在聊天中的信息。需注意，该项目是从 modelcontextprotocol/servers 提取出来以创建独立实现。

🚀 快速开始

作为独立包使用

安装依赖：

npm install mcp-memory-server

运行命令：

npx mcp-memory-server

Docker 部署

构建镜像：

docker build -t mcp/memory -f src/Dockerfile .

✨ 主要特性

• 实现知识图谱的持久化内存，可利用本地知识图谱助力Claude记住用户聊天信息。
• 提供了实体和关系的核心概念，支持实体的创建、查询、更新和删除操作。

🔧 技术细节

核心概念

实体

实体是知识图谱中的核心元素，每个实体都有唯一标识符和一组属性。

• 结构：
  • id：唯一标识符。
  • type：类型（例如：人、组织、地点等）。
  • properties：属性，包含：
    • name：名称
    • description：描述
    • relations：关系列表
• 示例：

{
  "id": "user_123",
  "type": "person",
  "properties": {
    "name": "张三",
    "age": 30,
    "job": "软件工程师"
  }
}

关系

关系表示实体之间的连接，具有方向性和权重。

• 结构：
  • id：唯一标识符。
  • from：源实体ID。
  • to：目标实体ID。
  • type：类型（例如：knows, works_at, lives_in）。
  • weight：权重（默认为1）。
• 示例：

{
  "id": "relation_456",
  "from": "user_123",
  "to": "company_789",
  "type": "works_at",
  "weight": 0.8
}

📚 详细文档

API

创建实体

async createEntity(properties) => Entity

• 参数：
  • properties：实体属性。
• 返回：新创建的实体对象。

查询实体

async getEntity entityId => Optional<Entity>

• 参数：
  • entityId：实体ID。
• 返回：如果存在，则返回实体；否则返回 null。

更新实体

async updateEntity entityId, properties => Entity

• 参数：
  • entityId：实体ID。
  • properties：新属性。
• 返回：更新后的实体对象。

删除实体

async deleteEntity entityId => boolean

• 参数：
  • entityId：实体ID。
• 返回：删除成功则返回 true，否则 false。

📄 许可证

本 MCP 服务器根据 MIT 许可证发布。这意味着你可以自由地使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参见项目存储库中的 LICENSE 文件。

系统提示示例（用于 Claude 的自定义指令）

遵循以下步骤进行每次交互：

1. 用户识别：
   - 假设你正在与 default_user 互动
   - 如果尚未确定 default_user，请主动尝试识别

2. 内存检索：
   - 总是从说“Remembering...”开始，从知识图谱中检索所有相关信息
   - 将你的知识图谱称为“memory”

3. 内存：
   - 在与用户交流时，注意任何新信息，包括以下类别：
     a) 基本人格（年龄、性别、位置、职位、教育水平等）
     b) 行为（兴趣、习惯等）
     c) 偏好（沟通风格、首选语言等）
     d) 目标（目标、目标、抱负等）
     e) 关系（个人和职业关系，最多三级）

4. 内存更新：
   - 如果在交互中收集到任何新信息，请按以下方式更新内存：
     a) 为重复出现的组织、人物和重要事件创建实体
     b) 使用关系将它们与当前实体连接
     c) 将事实存储为观察结果