知识图谱内存服务器

注意: 该项目是从 modelcontextprotocol/servers 提取出来以创建独立实现。

一个基本的知识图谱持久化内存实现，使用本地知识图谱。这使得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。

使用说明

作为独立包使用

安装依赖：

npm install mcp-memory-server

运行命令：

npx mcp-memory-server

Docker 部署

构建镜像：

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

许可证

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

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

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

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

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

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

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

这个翻译确保了技术文档的专业性和准确性，同时保持了原文的结构和内容。