forked https://github.com/modelcontextprotocol/servers/tree/main

知识图谱内存服务器

使用本地知识图谱实现的一种持久化内存的基本实现。这使得Claude能够在多个聊天中记住关于用户的信息。

核心概念

实体

实体是知识图谱中的主要节点。每个实体包含：

• 唯一名称（标识符）
• 实体类型（例如，“人”，“组织”，“事件”）
• 观察列表

示例：

{
  "name": "John_Smith",
  "entityType": "person",
  "observations": ["讲流利的西班牙语"]
}

关系

关系定义了实体之间的有向连接。它们总是以主动语态存储，并描述实体之间如何交互或关联。

示例：

{
  "from": "John_Smith",
  "to": "Anthropic",
  "relationType": "在...工作"
}

观察

观察是对实体的离散信息片段。它们：

• 存储为字符串
• 附属于特定实体
• 可以独立添加或删除
• 应该是原子的（每个观察一个事实）

示例：

{
  "entityName": "John_Smith",
  "observations": [
    "讲流利的西班牙语",
    "于2019年毕业",
    "喜欢早晨会议"
  ]
}

API

工具

• 创建实体

  • 在知识图谱中创建多个新实体
  • 输入：entities（对象数组）
    • 每个对象包含：
      • name（字符串）：实体标识符
      • entityType（字符串）：类型分类
      • observations（字符串数组）：相关观察
  • 忽略已存在的实体名称

• 创建关系

  • 创建实体之间的多个新关系
  • 输入：relations（对象数组）
    • 每个对象包含：
      • from（字符串）：源实体名称
      • to（字符串）：目标实体名称
      • relationType（字符串）：主动语态的关系类型
  • 跳过重复的关系

• 添加观察

  • 向现有实体添加新的观察
  • 输入：observations（对象数组）
    • 每个对象包含：
      • entityName（字符串）：目标实体
      • contents（字符串数组）：要添加的新观察
  • 返回每个实体添加的观察
  • 如果实体不存在则失败

• 删除实体

  • 删除实体及其关系
  • 输入：entityNames（字符串数组）
  • 级联删除相关关系
  • 如果实体不存在则静默操作

• 删除观察

  • 从实体中删除特定观察
  • 输入：deletions（对象数组）
    • 每个对象包含：
      • entityName（字符串）：目标实体
      • observations（字符串数组）：要删除的观察
  • 如果观察不存在则静默操作

• 删除关系

  • 从图中删除特定关系
  • 输入：relations（对象数组）
    • 每个对象包含：
      • from（字符串）：源实体名称
      • to（字符串）：目标实体名称
      • relationType（字符串）：关系类型
  • 如果关系不存在则静默操作

• 读取图谱

  • 读取整个知识图谱
  • 不需要输入
  • 返回完整的图结构，包括所有实体和关系

• 搜索节点

  • 根据一个或多个关键词搜索节点
  • 输入：query（字符串）
    • 空格分隔的关键词（例如，“预算 功能”）
    • 多个关键词被视为OR条件
  • 搜索范围：
    • 实体名称
    • 实体类型
    • 子域
    • 观察内容
  • 匹配行为：
    • 不区分大小写
    • 部分词匹配
    • 任何关键词可以匹配任何字段
    • 返回匹配任意关键词的实体
  • 返回匹配的实体及其关系
  • 示例查询：
    • 单个关键词：“预算”
    • 多个关键词：“预算 功能”
    • 带特殊字符：“预算 & 功能”

• 打开节点

  • 根据名称检索特定节点
  • 输入：names（字符串数组）
  • 返回：
    • 请求的实体
    • 请求实体之间的关系
  • 静默跳过不存在的节点

使用Claude Desktop

设置

将以下内容添加到您的claude_desktop_config.json：

Docker

{
  "mcpServers": {
    "memory": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/memory"]
    }
  }
}

NPX

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}

NPX带自定义设置

服务器可以通过以下环境变量进行配置：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ],
      "env": {
        "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
      }
    }
  }
}

• MEMORY_FILE_PATH：内存存储JSON文件的路径（默认：服务器目录中的memory.json）

系统提示

利用记忆的提示取决于使用场景。更改提示有助于模型确定创建记忆的频率和类型。

这是一个用于聊天个性化示例提示。您可以在Claude.ai项目的“自定义指令”字段中使用此提示。

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

1. 用户识别：
   - 您应假设与default_user交互
   - 如果尚未识别default_user，请积极尝试识别。

2. 记忆检索：
   - 开始聊天时，仅说“正在回忆...”并从您的知识图谱中检索所有相关信息
   - 总是将您的知识图谱称为您的“记忆”
   - 当搜索您的记忆时，您可以使用多个关键词来查找相关信息
   - 示例搜索：
     * 单一概念：“编程”
     * 相关概念：“编程 Python”
     * 具体领域及角色：“工作 工程师”

3. 记忆创建：
   - 在与用户的对话中，注意任何符合以下类别的新信息：
     a) 基本身份（年龄、性别、位置、职位、教育水平等）
     b) 行为（兴趣、习惯等）
     c) 偏好（沟通风格、首选语言等）
     d) 目标（目标、目标、抱负等）
     e) 关系（个人和职业关系，最多三度分离）
   - 存储信息时，使用具体的描述性关键词，以便未来搜索

4. 记忆更新：
   - 如果在互动期间收集了任何新信息，请按以下方式更新您的记忆：
     a) 为反复出现的组织、人员和重要事件创建实体
     b) 使用关系将它们连接到当前实体
     c) 将有关他们的事实作为观察存储
     d) 使用清晰且可搜索的术语在实体名称和观察中，以便未来检索

构建

Docker：

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

许可证

此MCP服务器根据MIT许可证授权。这意味着您可以自由地使用、修改和分发软件，但需遵守MIT许可证的条款和条件。更多详情，请参阅项目仓库中的LICENSE文件。