Memory MCP Server

Memory MCP Server

一款提供知识图谱管理功能的模型上下文协议服务。此服务支持大模型在持久化知识图谱中创建、读取、更新和删除实体及关系，帮助 AI 助手在不同对话中保留记忆。这是官方 TypeScript Memory MCP Server 的 Swift 实现。

注意： 此 Swift 版本要求 macOS 14.0 或更高版本。如需更广泛的平台支持（包括 Windows、Linux 和 macOS 11.0+），请查看 Go 语言实现：memory-mcp-server-go。

✨ 功能

• 知识图谱存储：维护由实体及其关系构成的持久化图谱
• 实体管理：使用自定义类型创建、检索、更新和删除实体
• 关系追踪：以主动语态定义和管理实体之间的关系
• 观察记录系统：随时间添加和删除有关实体的观察记录
• 强大的搜索功能：按名称、类型或观察记录内容查找相关节点
• 持久化存储：数据以简单的 JSON 格式在不同会话间持久保存

可用工具

• create_entities - 在知识图谱中创建多个新实体

  • entities (数组，必填)：要创建的实体对象数组
    • name (字符串)：实体名称
    • entityType (字符串)：实体类型
    • observations (字符串数组)：与实体相关的观察记录

• create_relations - 在实体之间创建多个新关系

  • relations (数组，必填)：关系对象数组
    • from (字符串)：关系起始实体的名称
    • to (字符串)：关系目标实体的名称
    • relationType (字符串)：关系类型（使用主动语态）

• add_observations - 为现有实体添加新的观察记录

  • observations (数组，必填)：要添加的观察记录数组
    • entityName (字符串)：要添加观察记录的实体名称
    • contents (字符串数组)：要添加的观察记录

• delete_entities - 删除多个实体及其相关关系

  • entityNames (数组，必填)：要删除的实体名称数组

• delete_observations - 从实体中删除指定的观察记录

  • deletions (数组，必填)：要删除的观察记录数组
    • entityName (字符串)：包含这些观察记录的实体名称
    • observations (字符串数组)：要删除的观察记录

• delete_relations - 从知识图谱中删除多个关系

  • relations (数组，必填)：要删除的关系对象数组
    • from (字符串)：源实体名称
    • to (字符串)：目标实体名称
    • relationType (字符串)：关系类型

• read_graph - 读取整个知识图谱

  • 无需参数

• search_nodes - 根据查询在知识图谱中搜索节点

  • query (字符串，必填)：用于匹配实体名称、类型和观察记录的搜索查询

• open_nodes - 按名称打开知识图谱中的指定节点

  • names (数组，必填)：要检索的实体名称数组

安装

选项 1：一行安装（curl）

最简单的安装方式是使用一行安装程序。它会自动下载最新版本，并将其安装到主目录下的 ~/.local/bin：

curl -fsSL https://raw.githubusercontent.com/okooo5km/memory-mcp-server/main/install.sh | bash

安装程序将：

• 如果 ~/.local/bin 不存在，则创建该目录
• 将此目录添加到 PATH（在 .zshrc 或 .bashrc 中）
• 下载并安装最新版本
• 将二进制文件设为可执行

选项 2：从源代码构建

1. 克隆仓库：

   git clone https://github.com/okooo5km/memory-mcp-server.git
   cd memory-mcp-server
   

2. 构建项目：

   swift build -c release
   

3. 安装二进制文件：

   # Install to user directory (recommended, no sudo required)
   mkdir -p ~/.local/bin
   cp $(swift build -c release --show-bin-path)/memory-mcp-server ~/.local/bin/
   

   请将 ~/.local/bin 添加到 shell 配置文件中，确保它位于 PATH 中：

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
   source ~/.zshrc  # or source ~/.bashrc
   

命令行参数

该服务支持以下命令行参数：

• -h, --help：显示有关服务、用法和可用选项的帮助信息
• -v, --version：显示 memory-mcp-server 的版本号

使用示例：

# Display help information
memory-mcp-server --help

# Display version information
memory-mcp-server --version

配置

环境变量

该服务支持以下环境变量：

• MEMORY_FILE_PATH：用于存储知识图谱的自定义路径（可选）
  • 如果未指定，默认为当前工作目录下的 memory.json
  • 可以是绝对路径，也可以是相对于当前工作目录的路径

启动服务时，可以在日志中查看配置的文件路径。

export MEMORY_FILE_PATH="/path/to/your/memory.json"

为 Claude.app 配置

将以下内容添加到 Claude 设置中：

"mcpServers": {
  "memory": {
    "command": "memory-mcp-server",
    "env": {
      "MEMORY_FILE_PATH": "/path/to/your/memory.json"
    }
  }
}

为 Cursor 配置

将以下配置添加到 Cursor 编辑器的 Settings - mcp.json 中：

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp-server",
      "env": {
        "MEMORY_FILE_PATH": "/path/to/your/memory.json"
      }
    }
  }
}

为 Chatwise 配置

在 Chatwise 的 Settings - Tools 中添加 Memory MCP 服务。

系统提示词示例

你可以使用以下系统提示词，帮助 Claude 有效利用 memory-mcp-server：

You have access to a Knowledge Graph memory system, which can store and retrieve information across conversations. Use it to remember important details about the user, their preferences, and any facts they've shared.

When you discover important information, save it using memory tools:
- `create_entities` to add new people, places, or concepts
- `create_relations` to record how entities relate to each other
- `add_observations` to record facts about existing entities

Before answering questions that might require past context, check your memory:
- `search_nodes` to find relevant information
- `open_nodes` to retrieve specific entities
- `read_graph` to get a complete view of your knowledge

Always prioritize information from your memory when responding to the user, especially when they reference past conversations.

开发要求

• Swift 6.0 或更高版本
• macOS 14.0 或更高版本
• MCP Swift SDK 0.2.0 或更高版本

知识图谱结构

Memory MCP Server 使用简单的图结构来存储知识：

• 实体：图中的节点，包含名称、类型和观察列表
• 关系：实体之间的边，其关系类型使用主动语态
• 观察：与实体相关的事实或详细信息

知识图谱以逐行 JSON 文件的形式持久化到磁盘，其中每一行都是一个实体或关系对象。

使用示例

创建实体

{
  "entities": [
    {
      "name": "John Smith",
      "entityType": "Person",
      "observations": ["Software engineer", "Lives in San Francisco", "Enjoys hiking"]
    },
    {
      "name": "Acme Corp",
      "entityType": "Company",
      "observations": ["Founded in 2010", "Tech startup"]
    }
  ]
}

创建关系

{
  "relations": [
    {
      "from": "John Smith",
      "to": "Acme Corp",
      "relationType": "works at"
    }
  ]
}

添加观察

{
  "observations": [
    {
      "entityName": "John Smith",
      "contents": ["Recently promoted to Senior Engineer", "Working on AI projects"]
    }
  ]
}

搜索节点

{
  "query": "San Francisco"
}

打开特定节点

{
  "names": ["John Smith", "Acme Corp"]
}

使用场景

• AI 助手的长期记忆：让 AI 助手记住用户偏好、过去的交互和重要事实
• 知识管理：整理有关人物、地点、事件和概念的信息
• 关系跟踪：维护实体之间的关系网络
• 上下文持久化：在多个会话中保留重要上下文
• 日志和每日记录：长期保存结构化的事件、活动和感想记录，便于按时间顺序检索过去的经历并建立关联

版本历史

请参阅 GitHub Releases，了解版本历史和变更日志。

☕️ 支持项目

如果你觉得 Memory MCP Server 有帮助，请考虑支持其开发：

• ⭐️ 在 GitHub 上为项目点星
• 🐛 报告错误或提出功能建议
• 💝 通过以下方式支持：

许可证

memory-mcp-server 基于 MIT License 授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。

关于

这是一个使用 Swift 实现的、适用于 Model Context Protocol（MCP）的知识图谱记忆服务，可为大模型提供持久记忆能力。本项目基于官方 TypeScript 实现，并使用 MCP Swift SDK 以 Swift 重写。