MCP Memory Graph Server

MCP Memory Graph Server

概述

Memory Graph Server 为知识图谱提供持久化存储层，支持：

• 存储实体及其属性
• 管理实体之间的关系
• 查询和遍历图结构
• 实时更新和修改

功能

• 基于 MongoDB 的持久化存储
• 图操作（创建、读取、更新、删除）
• 实体管理
• 关系处理
• 查询功能
• 实时更新

配置

设置免费的 MongoDB Atlas 集群（快速入门）

如果你尚未运行 MongoDB 实例，可以在几分钟内于 MongoDB Atlas（https://cloud.mongodb.com）上启动一个免费云集群：

1. 注册 / 登录
   打开 https://cloud.mongodb.com 并创建账户。你可以使用电子邮件注册，也可以通过 Google 或 GitHub 登录。

2. 创建项目和集群
   创建一个新 Project（例如 mcp-memory），然后选择 Create → Deployment → Create a cluster。 选择 Free Shared (M0) 层级，选择离你最近的服务提供商和区域，为集群命名，然后点击 Create。 配置大约需要 2～3 分钟。

3. 创建数据库用户
   前往 Database Access → Add New Database User。 – 选择 Password 身份验证。 – 输入 Username（例如 mcp_user）和强度足够的 Password（或自动生成密码）。 – 如需快速测试，为该用户授予 Read and write to any database 权限（之后可以收紧权限）。 – 点击 Add User，并将凭据妥善保存。

4. 允许你的 IP 地址
   前往 Network Access → Add IP Address，将 MCP 服务连接时使用的公网 IP 地址加入白名单。 你可以点击 Add Current IP Address，也可以手动指定。

5. 获取连接字符串（URI）
   在 Database Deployments 页面点击 Connect → Drivers，选择 Python 并复制 URI，其格式如下：

   mongodb+srv://<username>:<password>@<cluster>.mongodb.net/?retryWrites=true&w=majority
   

   将 <username>/<password> 替换为第 3 步中的凭据，并可选择添加 /<database> 以指定默认数据库，例如 /mcp_memory。

6. 配置 Memory Graph Server
   通过该服务所需的环境变量导出连接字符串：

   export MCP_MONGO_MEMORY_CONNECTION="mongodb+srv://mcp_user:<password>@cluster0.mongodb.net/mcp_memory?retryWrites=true&w=majority"
   

   保留 URI 两侧的引号，以确保特殊字符得到保留，并且切勿将此字符串提交到版本控制中。

现在，你可以按照 MCP 服务配置部分中的说明启动服务。

直接使用环境变量

或者，你也可以直接设置所需的环境变量：

MCP_MONGO_MEMORY_CONNECTION=mongodb://username:password@host:port/database

安装和设置

前提条件

1. 安装 uvx（如果尚未安装）：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 设置 MongoDB 连接（参见下方的配置部分）

MCP 服务配置

将以下代码片段添加到你的 MCP 配置中：

{
  "mcpServers": {
    "Memory": {
      "command": "/path/to/local/bin/uvx",
      "args": [
        "mongo-memory"
      ],
      "env": {
        "MCP_MONGO_MEMORY_CONNECTION": "mongodb://username:password@host:port/database"
      }
    }
  }
}

将 /path/to/local/bin/ 替换为你的 uvx 实际路径。 将连接字符串替换为你自己的 MongoDB 凭据。

可用操作

该服务为 AI Agent 提供以下操作：

实体管理：

• create_entities - 创建具有唯一名称的新实体
• get_entity - 按名称检索单个实体
• update_entity - 更新现有实体数据
• delete_entity - 删除实体
• find_entities - 按查询条件搜索实体

关系管理：

• create_relationship - 创建实体之间的关系
• get_relationships - 按筛选条件检索关系
• delete_relationship - 删除指定关系

记忆结构：

• get_memory_structure - 获取当前记忆组织结构
• get_usage_guide - 获取全面的使用示例和最佳实践

如需详细的使用示例、模式和最佳实践，AI Agent 应调用 get_usage_guide()。

开发

请参阅 DEVELOPMENT.md，了解开发环境设置和指南。

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE。