Memdata MCP

🚀 memdata-mcp

MemData-mcp 是为 MemData 打造的 MCP 服务器，为 AI 智能体提供持久化内存支持。借助它，Claude、Cursor 或任何支持 MCP 的 AI 都能在不同对话间拥有长期记忆能力。其核心功能是存储笔记、决策和上下文信息，并能在后续进行语义化检索，让你的 AI 记住一切。

🚀 快速开始

人类用户使用方式

使用 API 密钥，你可以自行管理订阅，让你的 AI 拥有记忆能力。

1. 前往 memdata.ai/dashboard/api-keys 获取 API 密钥。
2. 将密钥添加到你的 MCP 配置文件中：
   • Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "memdata": {
      "command": "npx",
      "args": ["memdata-mcp"],
      "env": {
        "MEMDATA_API_KEY": "md_your_key"
      }
    }
  }
}

- **Claude Code** (`~/.claude.json` 或项目 `.mcp.json`)：

{
  "mcpServers": {
    "memdata": {
      "command": "npx",
      "args": ["memdata-mcp"],
      "env": {
        "MEMDATA_API_KEY": "md_your_key"
      }
    }
  }
}

- **Cursor** (`~/.cursor/mcp.json`)：

{
  "mcpServers": {
    "memdata": {
      "command": "npx",
      "args": ["memdata-mcp"],
      "env": {
        "MEMDATA_API_KEY": "md_your_key"
      }
    }
  }
}

3. 重启客户端，此时你应该能看到 MemData 工具已可用。

智能体使用方式

v1.7.0 新增功能 - 无需 API 密钥，也无需人工干预，仅需钱包即可使用。

为何重要

传统的 AI 记忆依赖与人类账户绑定的 API 密钥，但 24 小时运行的自主智能体需要的记忆具备以下特性：

• 跨对话持久存在 - 能在不同主机和平台上持续使用。
• 归属于智能体本身 - 钱包地址即身份标识，可移植且具有自主性。
• 自主支付 - 无需订阅，也无需人工审批。

这是为自主智能体经济构建的记忆基础设施。

配置步骤

{
  "mcpServers": {
    "memdata": {
      "command": "npx",
      "args": ["memdata-mcp"],
      "env": {
        "X402_WALLET_KEY": "your_private_key_hex"
      }
    }
  }
}

工作原理

1. 智能体发起请求（查询、存储等）。
2. 服务器返回 402 Payment Required 并附带价格信息。
3. MCP 自动使用智能体的钱包签署支付请求。
4. 请求完成，记忆数据完成存储或检索。

你的钱包地址就是你的身份标识。使用相同的钱包，无论在任何主机或平台上，都能访问相同的记忆数据。

定价（Base 链上 USDC）

MCP 会使用 @x402/fetch 自动处理 402 响应和支付签名。

了解更多

• x402 协议 - 基于 HTTP 的原生支付协议。
• ERC - 8004 - 无信任智能体标准（MemData 与之兼容）。

✨ 主要特性

解决 AI 会话记忆问题

AI 助手在不同会话间会遗忘信息，而 MemData 能解决这一问题：

• 数据摄入：可直接导入会议记录、文档、决策等内容。
• 数据处理：自动对内容进行分块和向量化处理。
• 数据查询：支持使用自然语言提问，返回相关上下文信息。
• 数据标签：AI 会自动为内容添加标签，方便后续检索。

支持多种客户端

可与 Claude Desktop、Claude Code、Cursor 以及任何 MCP 客户端配合使用。

v1.7.0 新增功能

支持自主智能体，智能体可使用钱包自行支付，无需 API 密钥和人工干预。

工具丰富

提供了一系列核心工具、身份与会话管理工具，且在不同版本中不断进行功能优化和用户体验提升。

📦 安装指南

根据不同的使用主体（人类用户或智能体），按照上述“快速开始”部分的对应步骤进行配置即可。

💻 使用示例

基础用法

配置完成后，你只需与你的 AI 进行对话：

你: "Remember that we chose PostgreSQL for the user service"
AI: [calls memdata_ingest] → Stored in memory

... days later ...

你: "What database are we using for users?"
AI: [calls memdata_query] → "PostgreSQL for the user service" (73% match)

📚 详细文档

支持的内容类型

注意：MCP 工具可直接处理文本内容。对于文件（PDF、图像、音频），请使用 仪表盘 或 HTTP API。

工具说明

核心工具

身份与会话工具（v1.2.0+）

v1.5.0 - 会话开始工具重命名

• memdata_whoami → memdata_session_start - 为了更清晰，重命名后的名称表明“每次会话开始时先调用此工具”。描述中包含 🚀 图标，以便在工具列表中更醒目。

v1.4.0 用户体验改进

• 可视化匹配质量：查询结果显示 🟢🟡🟠🔴 指标，表明匹配强度。
• 更智能的会话开始：首次使用时提示设置身份，对近期活动进行去重处理。
• 更好的存储反馈：显示分块数量并解释异步 AI 标签。
• 会话连续性：强调“继续工作”，并提醒使用 session_end。

各工具详细说明

memdata_ingest

将文本存储到长期记忆中。

"Remember that we decided to use PostgreSQL for the new project."

参数：

• content (字符串) - 要存储的文本
• name (字符串) - 来源标识符（例如，"meeting - notes - jan - 29"）

memdata_query

使用自然语言搜索记忆。

"What database did we choose?"

参数：

• query (字符串) - 自然语言搜索内容
• limit (数字，可选) - 最大结果数（默认值：5）

memdata_list

列出所有已存储的记忆，并显示分块数量。

memdata_delete

根据工件 ID 删除记忆（可从 memdata_list 获取 ID）。

memdata_status

检查 API 连接性和存储使用情况。

memdata_session_start

🚀 每次会话开始时首先调用此工具。对于会话连续性至关重要。

"Start my session" / "What was I working on?"

返回：智能体名称、身份摘要、会话计数、上一次会话交接信息、近期活动。

v1.5.0：从 memdata_whoami 重命名而来，名称更清晰地表明“先调用我”。

memdata_set_identity

设置或更新你的智能体身份。 参数：

• agent_name (字符串，可选) - 你的名称（例如，"MemBrain"）
• identity_summary (字符串，可选) - 你是谁以及你的目的

memdata_session_end

在会话结束前保存上下文信息。下一次会话将看到此交接信息。 参数：

• summary (字符串) - 本次会话发生的事情
• working_on (字符串，可选) - 当前关注的内容
• context (对象，可选) - 要保留的其他上下文信息

memdata_query_timerange

在指定日期范围内搜索记忆。

"What did I work on last week?"

参数：

• query (字符串) - 自然语言搜索内容
• since (字符串，可选) - ISO 日期（例如，"2026 - 01 - 01"）
• until (字符串，可选) - ISO 日期（例如，"2026 - 01 - 31"）
• limit (数字，可选) - 最大结果数

memdata_relationships

查找在你的记忆中共同出现的实体。

"Who has John Smith worked with?"

参数：

• entity (字符串) - 要搜索的名称
• type (字符串，可选) - 按类型过滤（人员、公司、项目）
• limit (数字，可选) - 最大关联数量

工作原理

1. 数据摄入：文本被分块、嵌入并存储。
2. 数据查询：使用语义相似度将你的问题与存储的记忆进行匹配。
3. 结果返回：返回相关内容并附带相似度得分。

相似度得分在 30 - 50% 通常表示匹配良好。语义搜索查找的是含义，而非关键词。

环境变量

注意：请使用 MEMDATA_API_KEY（订阅方式）或 X402_WALLET_KEY（按使用付费方式）其中之一，不要同时使用。

包功能说明

这是一个轻量级的 MCP 客户端，用于调用 MemData API。它不会：

• 在本地存储任何数据。
• 将数据发送到除 memdata.ai 之外的任何地方。
• 收集分析数据或遥测数据。

你可以在 src/index.ts 中查看源代码。

相关链接

• MemData - 主网站
• 仪表盘 - 管理你的记忆
• API 文档 - 完整文档
• GitHub - 本项目仓库

贡献

欢迎提交问题和拉取请求！这是托管的 MemData 服务的开源 MCP 客户端。

📄 许可证

本项目采用 MIT 许可证。