Mnemoverse Memory

Mnemoverse Memory

通过 MCP 为 AI Agent 提供托管式长期记忆。 两次调用即可完成基本操作：memory_write 保存记忆，memory_read 根据自然语言查询再次找到它。两者都传入 domain: "user:<id>"，即可将每位用户的记忆分开存储（这是账户内的命名空间，不是权限边界）。将找回的记忆评为有帮助或有误导性，可以重新调整后续返回结果的排序（memory_feedback）。

免费计划，无需信用卡： 每天 1,000 次查询（读取、写入和反馈合计），10,000 个存储单元，每分钟 60 次请求。计划与限额：mnemoverse.com/pricing

连接方式： 在托管端点 https://mcp.mnemoverse.com/mcp 使用 OAuth 登录，或使用 API 密钥在本地运行此软件包。下方提供 Claude Code、Claude Desktop、Cursor、VS Code、Devin Desktop（原 Windsurf）、Zed、JetBrains、Cline、Gemini CLI 和 ChatGPT 的设置说明。其他宿主的步骤：mnemoverse.com/docs/api/install-by-host

共享房间（测试版）支持多个 Agent 使用同一份记忆。

@mnemoverse/mcp-memory-server 是适用于托管式 Mnemoverse 记忆引擎的 MCP 服务，采用 MIT 许可证。

什么是 Mnemoverse Memory？

Mnemoverse 是一款托管式 AI Agent 记忆引擎，通过 Model Context Protocol 访问。它会存储 Agent 学到的内容（决策、偏好、经验），并在任何已连接的工具中提供这些内容，因此同一份记忆可以通过一个账户在 Claude Code、Cursor、VS Code 和 ChatGPT 之间通用：在本地配置中使用 API 密钥，或在托管端点使用 OAuth 登录。

这里哪些内容开源，哪些不开源。 本仓库中的 MCP 服务采用 MIT 许可证，Python SDK 也一样。它们所连接的记忆引擎是提供免费层级的托管服务。对于有安全或合规要求的场景，可通过协议在 Enterprise 计划中自托管引擎；默认情况下，我们会为你托管。

对比

如今，大多数 Agent 记忆存在于以下三种位置之一。按工具设置的指令文件（CLAUDE.md、.cursorrules、AGENTS.md）可以纳入版本控制且便于阅读；每次新会话都会重新读取这些文件，提交后的文件也会随仓库一起传播。但文件只对会查找该文件名的工具生效，因此，为 Claude Code 编写的规则不会出现在 ChatGPT 对话中。RAG 后面的向量存储按相似度检索，而建议是否有帮助或造成误导并不会改变相似度。本地优先的记忆服务在隐私和延迟方面更有优势，但需要你自行运行和更新基础设施。在这样的选择中，Mnemoverse 是托管式的跨工具方案：无需部署，一个账户即可随处使用；将找回的记忆评为有帮助或有误导性，可以重新调整后续返回结果的排序。如果你需要在自己的安全边界内使用记忆，本地优先的服务会更合适；本服务默认采用托管方式，也可通过协议在 Enterprise 计划中自托管。

⭐ 如果 Mnemoverse 帮你省去了向 Agent 反复解释背景的麻烦，给仓库点个星。这能帮助其他开发者发现它。

快速入门

无需密钥：托管端点

如果客户端通过 OAuth 登录，则完全不需要密钥。前往 console.mnemoverse.com 创建免费账户（无需信用卡），然后连接托管端点。

Claude Code：

claude mcp add --scope user --transport http mnemoverse https://mcp.mnemoverse.com/mcp

然后启动 Claude Code，运行 /mcp，选择 mnemoverse 并点击 Authenticate。运行该命令时已经启动的会话不会加载新服务：先退出，然后重新启动 claude。

Cursor，在 .cursor/mcp.json 中：

{ "mcpServers": { "mnemoverse": { "url": "https://mcp.mnemoverse.com/mcp" } } }

Claude Desktop、Devin Desktop（原名 Windsurf）、VS Code 和 ChatGPT：远程 MCP 设置。下方的本地服务是另一种方式：它在你的机器上运行，并读取 API 密钥。

1. 获取免费 API 密钥

前往 console.mnemoverse.com 注册——只需 30 秒，无需信用卡。

将密钥放入配置前，请先验证密钥。 两种方式都会在遮蔽输入的提示符下要求输入密钥，且绝不会将密钥作为命令参数传递，因此密钥既不会进入 shell 历史记录，也不会出现在进程列表中。

macOS、Linux、Git Bash：

printf 'Mnemoverse API key: '; read -rs KEY; echo
printf 'X-Api-Key: %s\n' "$KEY" | curl -s -H @- https://core.mnemoverse.com/api/v1/memory/stats; unset KEY

Windows PowerShell 5.1 和 PowerShell 7：

$k = [Net.NetworkCredential]::new('', (Read-Host 'Mnemoverse API key' -AsSecureString)).Password
try { (Invoke-WebRequest https://core.mnemoverse.com/api/v1/memory/stats -Headers @{ 'X-Api-Key' = $k } -UseBasicParsing).Content }
catch { if ($_.ErrorDetails.Message) { $_.ErrorDetails.Message } else { (New-Object IO.StreamReader($_.Exception.Response.GetResponseStream())).ReadToEnd() } }; Remove-Variable k

在 JSON 中，reason 位于 details 对象内（details.reason），与 details.keys_url 相邻；后者是用于创建密钥的控制台页面。

2. 连接到你的 AI 工具

两种标准配置分别适用于 Claude Code 和 Cursor。它们都先连接托管服务：通过浏览器登录，无需密钥。它们基于密钥的配置会在用户级别写入一次密钥，适用于所有项目；下文会分别说明各客户端的配置文件位置。请避免在项目配置文件中放入密钥：密钥存放在仓库内，可能随仓库一并提交，而密钥应保存在仓库外：

Claude Code — 托管服务，通过浏览器登录。无需 API 密钥，也无需安装任何内容：

claude mcp add --scope user --transport http mnemoverse https://mcp.mnemoverse.com/mcp

然后启动 Claude Code，运行 /mcp，选择 mnemoverse 并点击 Authenticate。如果是在 Claude Code 会话中运行该命令（无论是你运行的，还是 Claude 替你运行的），该会话都不会加载新服务：先退出，然后重新启动 claude。

如果要改用 API 密钥运行本地服务（Node.js 18 或更高版本），请将 mk_live_YOUR_KEY 替换为你自己的密钥。两者只能选其一，不能同时使用：它们共用名称 mnemoverse。

claude mcp add mnemoverse --scope user \
  -e MNEMOVERSE_API_KEY=mk_live_YOUR_KEY \
  -e MNEMOVERSE_API_URL=https://core.mnemoverse.com/api/v1 \
  -- npx -y @mnemoverse/mcp-memory-server@latest

在 Windows 上（PowerShell），请将相同命令粘贴为一行——PowerShell 不识别 \ 行续接符：

claude mcp add mnemoverse --scope user -e MNEMOVERSE_API_KEY=mk_live_YOUR_KEY -e MNEMOVERSE_API_URL=https://core.mnemoverse.com/api/v1 -- npx -y @mnemoverse/mcp-memory-server@latest

Cursor — 点击添加托管服务。Cursor 会通过浏览器让你登录，因此无需粘贴密钥：

此按钮会在 ~/.cursor/mcp.json 的 mnemoverse 项下写入 {"url": "https://mcp.mnemoverse.com/mcp"}。这是涵盖所有项目的全局配置。然后，在 Cursor 的 MCP 设置中点击 mnemoverse 旁边的 Connect（侧边栏中的 Customize；Cursor 3.21.16 中为 Cursor Settings → Tools & MCPs），并在浏览器中批准。Cursor 会执行登录，并自行保留令牌。 若要改用 API 密钥运行本地服务，请将以下 JSON 添加到 ~/.cursor/mcp.json，并与其中已有的服务合并；将 mk_live_YOUR_KEY 替换为你自己的密钥。请前往 console.mnemoverse.com 获取密钥。不要将其放入项目级的 .cursor/mcp.json：该文件位于仓库内，除非将其排除，否则会随仓库一并提交，而此配置中包含你的密钥。两项配置选其一，不要同时使用：它们共用名称 mnemoverse。

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "mnemoverse-api-key",
      "description": "Mnemoverse API key (starts with mk_live_), for this local package only: the hosted server https://mcp.mnemoverse.com/mcp signs in with OAuth and takes no key. Optional to install and inspect — the server starts and lists its tools without a key; every actual tool call requires one. Get one free in ~30s at https://console.mnemoverse.com",
      "password": true
    }
  ],
  "servers": {
    "mnemoverse": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "${input:mnemoverse-api-key}",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

{
  "context_servers": {
    "mnemoverse": {
      "source": "custom",
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

{
  "mcpServers": {
    "mnemoverse": {
      "command": "npx",
      "args": [
        "-y",
        "@mnemoverse/mcp-memory-server@latest"
      ],
      "env": {
        "MNEMOVERSE_API_KEY": "mk_live_YOUR_KEY",
        "MNEMOVERSE_API_URL": "https://core.mnemoverse.com/api/v1"
      }
    }
  }
}

⚠️ 编辑配置后，请重启 AI 客户端。 MCP 服务仅会在客户端启动时加载。

3. 试试看 — 用 30 秒验证是否正常

在 AI 聊天中粘贴以下内容：

“记住我最喜欢的 TypeScript 框架是 Hono，并调用 memory_write 将它保存下来。”

你的 Agent 应调用 memory_write，并确认已存储这条记忆。

然后打开一个新聊天 / 新会话（这正是重点——记忆会在重启后保留），并询问：

“我最喜欢的 TypeScript 框架是什么？”

你的 Agent 应调用 memory_read，找到对应条目，并回答“Hono”。如果成功，就说明已经配置好了。接下来，随心使用即可。

如果它不记得：请检查客户端是否已完全重启，以及配置中是否填写了真实的 mk_live_... 密钥，而不是占位符。使用托管服务时无需检查密钥；请确认浏览器登录已完成（在 Cursor 中，点击 mnemoverse 旁的 Connect）。

⭐ 如果它在第二个会话中记住了内容，请为仓库点星。这有助于其他开发者发现它。

4. 养成习惯

上述测试之所以有效，是因为你要求 Agent 调用工具。在日常工作中，除非有一条长期指令说明何时读取记忆、何时保存记忆，否则它不会这么做。setup_memory 提示词会为 Claude Code、Claude、Cursor 或 Codex 编写这些规则；让你的 Agent 使用记忆会说明规则应放在哪里，以及如何先确认工具正常工作。

工具

提示词

为将 MCP 提示词显示为命令的客户端提供四个命名提示词（Claude Code 中显示为 /mcp__mnemoverse__<name>）。它们都不会自行调用 API：其中三个会让模型使用上述工具，setup_memory 则为你自己的 Agent 提供规则。

资源

对于会附加 MCP 资源的客户端，memory://item/{memory_id} 会通过记忆 ID 打开一条已保存的记忆（即 memory_read 结果中的 id: 行）。它会以 JSON 格式返回记忆的 memory_id、content 和 domain。它只读取你自己的存储：无法通过 ID 打开从共享空间读取的记忆。

工具接口稳定性

每个已发布版本的 tools/list 都是固定的，因此客户端可以保存看到的列表，并按版本与服务当前提供的列表进行比较。

• 在 PATCH 版本内（x.y.Z）：工具名称、参数架构以及每个工具的 annotations 对象（title、readOnlyHint、destructiveHint、idempotentHint、openWorldHint）都不会改变。只有文本可以改变：描述和工具返回的内容，具体按 CHANGELOG 规则执行。
• 在 MINOR 版本内（x.Y.0）：可以新增工具和注解字段，但绝不移除或重命名，也不会悄然删除或翻转任何已声明的注解字段。每项新增内容都会在该版本的 CHANGELOG 中列出。MINOR 版本还可以为原先没有输出架构的工具新增输出架构（outputSchema，并在返回相同文本的同时返回 structuredContent）；声明后，该架构的字段也只能按同一规则新增。如果本服务的输出架构与托管连接器有意不同，CHANGELOG 条目会说明；目前包括：每个输出架构中的 memory_id，此处是普通字符串，而连接器中是经过 GUID 验证的字符串（本软件包的 ID 不透明）；memory_list_recent 的 next_cursor，此处为可选字段（当服务发送了客户端不会继续传递的延续令牌时，该字段缺省），而连接器中为必填字段；memory_stats，包含五个可选字段（episodes、prototypes、hebbian_edges、avg_valence、avg_importance），连接器的架构未声明这些字段；房间工具（memory_create_room、memory_invite_to_room、memory_join_room、memory_list_rooms），其中连接器标记为必填的若干字段在此处为可选字段（name、scope、already_member，以及邀请中的 code、scope、room_address 和 expires_at），因为此处如实呈现核心服务未发送某个值，而不是使用占位符；以及 memory_list_rooms 和 vault_list，如果某行缺少可用标识（room_id、address、role；alias、context），则会从数据中移除，并在 stderr 上报告一次，而不是向必填字段中写入空字符串；还有 memory_read 和 memory_list_recent，它们包含可选字段 rooms_not_searched（未指定范围的调用没有搜索的共享房间），而连接器的架构目前尚未声明该字段。
• **移除或重命名工具或工具的输入参数，或删除或重命名已声明的注解字段，**须提前一个 MINOR 版本公告：该工具（或参数）会保留，其描述会注明 deprecated since x.y, removed in x.z，并且变更只会在公告的版本中生效，同时附有对应的 CHANGELOG 条目。重命名的参数在此之前会同时接受新旧名称（0.11 将 memory_feedback 的 atom_ids 重命名为 memory_ids；旧名称在 0.13 中移除，此项变更是在 0.12 比首次公告所预期更早发布后公告的）。公告重命名时会同时列出旧名称和新名称；仅凭版本号对无法说明客户端应查找什么。由于 MINOR 版本可以新增字段但不能移除字段，重命名的注解字段会在公告的版本生效前以两个名称同时声明。
• 同一版本的两个服务之间若有任何差异，均属于 bug。请附上两个服务的 tools/list 输出进行报告。例外情况由配置决定：基于 /shared 入口构建的服务可以在三个提及服务的描述中使用自己的名词（见下文 wording.serverNoun），这只会更改这三条描述文本，不会影响其他内容；工具名称、输入和输出架构以及注解绝不会因配置而异。

每个 inputSchema 和 outputSchema 都遵循 JSON Schema 2020-12；如果架构未指定方言，这是 MCP 默认采用的方言，且不会指定其他方言（#189）。 上方列表是当前提供的功能：十一个工具均声明了全部四项提示。托管连接器 mcp.mnemoverse.com/mcp 提供相同的功能，其注册内容来自此软件包，并采用该软件包固定的版本。该列表以 tools.json 的形式发布，根据已构建的服务生成（每个工具的名称、标题、描述和注解）；如果列表与服务注册的内容不一致，测试套件和发布工作流都会失败，而 .mcpb 清单中的工具列表也由此生成。

如果托管连接器在会话中停止响应。 客户端可能仍显示连接器已连接，但该会话中的每次调用都会失败，并提示“未连接”。在 claude.ai 上重新连接无法恢复已经卡住的会话；请在会话内重新连接（在 Claude Code 中，运行 /mcp，然后重新登录）。与此同时，使用与快速入门中相同账户的 API 密钥配置的本地服务可以访问同一份记忆，且不依赖该会话的登录状态。

基于此软件包构建第二个 MCP 服务

@mnemoverse/mcp-memory-server/shared 是其他服务注册这些相同工具时使用的入口点，可避免各自维护一份副本（ADR-025，mnemoverse-core）。它导出 registerMemoryTools/registerMemoryPrompts/registerMemoryResources、三个类型化错误类（ApiError、NetworkError、UnreadableBodyError）、MAX_RESULT_CHARS/capResult，以及托管部署可注入的两个可选依赖，让服务以自己的方式与用户交互：wording（服务自身对服务的称呼和错误用语，包括一种 OAuth 模式，在该模式下，任何 401 或 403 错误说明都不会提及 API 密钥）和 writeAuthor（为写入操作背后的最终用户背书）。完整契约请参阅 docs/shared.md。

使用场景

最先体现价值的模式是跨工具连续性：在 Claude Code 中结对时做出的决定，一小时后打开 Cursor 仍然可用；而你在 VS Code 中说明的偏好，当晚在 ChatGPT 会话中也能生效。团队也会以同样的方式使用共享空间——让 Agent 对代码库的经验教训在同一处不断积累，而不是每个成员都要重新讲一遍。为回忆出的记忆评定有帮助或有误导性，也会重新调整后续检索结果的排序；当存储内容增长到无人能手动整理时，这一点就很重要。

值得记录的具体内容：

• 用户偏好：“我使用深色模式”“相比 CSS 模块，我更喜欢 Tailwind”
• 项目背景：“此项目使用 PostgreSQL + Prisma”“部署到 Railway”
• 经验教训：“在此仓库中推送前务必运行测试”
• 已做决定：“我们选择 REST 而非 GraphQL，因为缓存更简单”
• 人员与角色：“Alice 是设计师，Bob 负责 API”
• 过去的错误：“不要在周五部署——这是惨痛教训”

通用记忆

同一个 API 密钥可用于所有工具。在 Claude Code 中写入记忆——在 Cursor 中读取。在 VS Code 中学到的内容——你的 GPT Custom Action 也能知道。

                    ┌── Claude Code (this MCP server)
                    ├── Cursor (this MCP server)
   Mnemoverse API ──├── VS Code (this MCP server)
   (one memory)     ├── GPT (Custom Actions)
                    ├── Python SDK (pip install mnemoverse)
                    └── REST API (curl)

配置

背后的研究

检索模型已公开发表：arXiv:2603.08965，并被 IEEE WCCI 2026 的 GRAAI 研讨会接收——该研究确立了记忆模型所基于的抽象发现方法。本 README 不会列出任何基准测试数据，无论是我们的还是其他人的：只有在有可复现的运行结果作为依据后，才会公布数据。

链接

设置和参考

• 文档
• Cursor · VS Code · Claude Code · ChatGPT
• Python SDK
• API 参考
• 控制台（获取 API 密钥）

背景阅读

• Memory MCP 服务对比 — 十三种已发布的方案，包括定价和在注册表中的收录情况
• 如何选择 Memory MCP 服务 — 帮你缩小选择范围的五个问题
• 什么是 AI Agent 记忆 — 该类别的说明
• 这是向量数据库吗？ — 记忆层有何不同
• 多 Agent 系统的共享记忆 — Rooms 的工作方式及其适用场景

其他安装方式

同一套记忆功能，针对偏好使用插件或扩展而非 MCP 配置块的宿主进行了打包。各方式的连接和身份验证流程有所不同，因此下方会分别说明，而不会声称它们都采用相同流程。

• Claude Code 插件 — 通过 MCP 使用远程端点，并通过 OAuth 登录，无需粘贴密钥。内置 agent-memory-discipline 技能

  claude plugin marketplace add mnemoverse/claude-plugin
  claude plugin install mnemoverse@mnemoverse
  

• Cursor 插件 — 使用相同的远程端点和登录方式
• Gemini CLI 扩展 — 使用相同的远程端点。gemini extensions install https://github.com/mnemoverse/gemini-extension
• VS Code 扩展（VS Code Marketplace、Open VSX、源代码）— 通过浏览器登录，并保留粘贴密钥作为备用命令
• 桌面扩展：此仓库中的 manifest.json 是一个 MCPB 清单。它与上述四种方式不同：它会将服务作为本地 node 进程运行，并从扩展设置中读取 MNEMOVERSE_API_KEY，而不是调用托管端点。打包后的 .mcpb 会随每次发布一同提供

与此服务分开管理的规范

• agent-memory-discipline — 规定 Agent 应何时在行动前回忆、行动后保存。采用 CC0 许可，与后端无关，可用于任何记忆存储，而不仅限于此项目。它在 .claude-plugin/ 下自带市场清单。
• awesome-agent-memory — 精选的该类别索引，采用 CC0 许可，包含与本项目竞争的服务

项目

• GitHub
• 发布版本
• MCP 注册表条目
• 参与贡献

隐私政策

此服务会将工具调用中携带的内容发送到 Mnemoverse API（core.mnemoverse.com），并使用你的 API 密钥进行身份验证；除此之外，不会发送它能看到的任何其他内容。它不会读取你的 AI 客户端对话历史、本地文件，或你未传入 memory_* / vault_* 工具的任何内容。存储的记忆归属于你的账户；Mnemoverse 绝不会出售这些记忆，也不会自行分享。唯一的分享途径由你自行创建：邀请他人加入共享房间，即授予对方的助手访问该房间记忆的权限，访问范围受邀请权限范围的限制。

各工具发送的数据：

有一项内容会在你未明确请求的情况下发出：自 0.8.1 起，当搜索或信息流返回空结果时，此服务会发送一到两次经身份验证的只读 GET 探测请求（/memory/rooms 和／或 /memory/stats），以便在空结果答复中说明未涵盖的内容。自 0.16.0 起，不带 domain 的搜索或信息流若确实返回结果，也会向 /memory/rooms 发送一次探测请求，以便在答复中列出未搜索的共享房间。这些探测请求仅携带你的 API 密钥，不携带其他内容，不会更改任何已存储的状态，并已在 变更日志 中披露。

许可证

MIT © Mnemoverse