Memory MCP Server

Memory MCP Server

一个以知识图谱的形式处理和保存记忆的 MCP 服务 Python 实现。

概述

MCP Server Memory 提供维护 AI 记忆持久化知识图谱的功能。它支持以实体、关系和观察项的形式存储、检索和查询结构化数据。这使 AI 系统能够跨会话存储和回忆信息。

功能

• 创建和管理包含结构化信息的实体
• 在实体之间建立类型化关系
• 向现有实体添加观察项
• 删除实体、关系和观察项
• 搜索知识图谱中的节点
• 按名称检索特定节点

工具

该服务实现了 MCP（Model Control Protocol）接口，提供以下工具：

• create_entities：在知识图谱中创建多个新实体
• create_relations：在实体之间创建多个新关系
• add_observations：向现有实体添加新的观察项
• delete_entities：删除实体及其关联关系
• delete_observations：从实体中删除特定观察项
• delete_relations：从图谱中删除特定关系
• read_graph：读取整个知识图谱
• search_nodes：搜索与查询匹配的节点
• open_nodes：按名称检索特定节点

安装

使用 uv（推荐）

uv add mcp-server-memory

使用 pip

pip install mcp-server-memory

使用方法

运行服务

# Run the server directly
mcp-server-memory

# Set custom memory file path
MEMORY_FILE_PATH=/path/to/memory.json mcp-server-memory

配置

为 MCP 客户端配置

将以下内容添加到 Claude（claude_desktop_config.json）或 Cursor（mcp.json）设置文件中：

"mcpServers": {
  "memory": {
    "command": "/path/to/uv",
    "args": [
      "--directory",
      "/path/to/mcp_server_memory/src",
      "run",
      "python",
      "-m",
      "mcp_server_memory"
    ],
    "env": {
      "MEMORY_FILE_PATH": "/path/to/memory.json"
    }
  }
}

"mcpServers": {
  "memory": {
    "command": "python",
    "args": ["-m", "mcp_server_memory"]
  }
}

配置记忆路径

默认情况下，知识图谱数据存储在包目录中的 memory.json 文件里。你可以使用 MEMORY_FILE_PATH 环境变量自定义存储位置。

开发

克隆仓库并安装开发依赖：

git clone https://github.com/jcdiv47/mcp-server-memory.git
cd mcp-server-memory
uv venv
source .venv/bin/activate
uv install -e ".[dev]"

许可证

mcp-server-memory 采用 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。