minnimemory

MinniMemoryMCP for Claude Code

MinniMemoryMCP 1.3.7 是 Claude Code 插件。它会检查 Claude Code 加载的记忆文件（CLAUDE.md、AGENTS.md、你的记忆文件夹），并将其编译为每轮都会加载的精简 AlwaysOnMemory 正文，以及仅在任务需要时才加载的 OnDemandMemory 文件。所有更改都可无损撤销：原始文件会先备份，执行 undo 后会逐字节还原。所有操作都在你的计算机上进行，只处理你自己的文件，并且只有在你提出请求时才会运行。由 MinniAI 构建。

要求

• PATH 中需有 Node.js 18.3 或更高版本。服务和钩子通过 node 运行。Claude Code 自身的安装程序不需要 Node，因此请先用 node --version 检查。
• 使用下方的一行安装命令需要 Claude Code 2.1.275 或更高版本；较旧版本需先添加市场（使用其下方的 shell 命令）。

安装

/plugin install minnimemory --marketplace MinniAI-com/minnimemory-plugin

也可以在 shell 中运行：claude plugin marketplace add MinniAI-com/minnimemory-plugin，然后运行 claude plugin install minnimemory@minniai。

此插件会在 Claude Code 中加载；当 Cowork 会话在你的计算机上运行时，也会加载。在 claude.ai 聊天中则会被忽略：本地 MCP 服务和钩子不会在那里运行。

每台计算机只选择一种安装方式。如果你之前运行过 npx minnimemory install，请先运行 npx -y minnimemory uninstall：否则服务会被注册两次，每条提示词都会启动两份钩子（第二份会保持静默，但你仍需为其启动付出开销）。

使用

在 Claude Code 的项目中，用以下三条提示词即可完成整个流程：

1. “用 minnimemory 清理我的记忆。”Claude 会调用 init，显示 Claude Code 在此处加载的内容地图、审计结果，以及执行 apply 会进行的更改。除了记录记忆加载位置的小型记录外，不会写入任何内容。
2. “应用它。”Claude 会调用 apply，返回一条命令和文件操作列表；只有在你通过审批提示后，这条命令才会运行。
3. 一周后，说“检查我的记忆。”Claude 会调用 doctor，显示发生的变化和重新应用计划；说“撤销记忆编译”即可还原原始文件。

相同的四个步骤也可以通过斜杠命令执行：/mcp__minnimemory__init、doctor、apply、undo。

运行、读取、写入和发送的内容

• 一个 MCP 服务（node server/cli.mjs mcp），提供四个工具：init、doctor、apply、 undo。它只读取工具调用指定的文件夹，以及你或 Claude 告诉它 Claude Code 要加载的文件；不会搜索任何内容。apply 和 undo 会返回一条命令和文件操作列表，只有在你批准后，Claude 才会运行该命令。该命令为 node "<plugin folder>/server/cli.mjs" apply --plan <hash> <folder>：它使用的是插件自身的文件， 绝不会下载文件。
• 三个钩子。 每次提示词发送前，drift 会检查你的记忆是否自上次应用后发生变化；如果有变化，就打印一行提示；hook 会在每个会话中添加一次与提示词匹配的那一小段记忆，并将其标记为数据；如果某段内容中含有看起来像凭据的一行文字，就不会添加，而是改为说明这一点。提示词钩子节省的内容是在我们自己的记忆文件夹中，通过 Claude Code 的实时会话测得的（具体数字见文档页面）；在其他文件夹中尚未测量。Claude Code 加载指令时，loaded 会在本地日志中记录加载的文件，供 init 之后读取。
• 也包含在程序包中，但插件不会运行。 server/cli.mjs 是 npm 包的命令行，因此还包含 npx 方式使用的 install 和 uninstall 命令，它们会运行 claude mcp add 和 claude mcp remove，并将 npx 形式的钩子写入设置中；此外还包含一个带有六个额外工具（recall、outline、list、audit、plan、compile）的 mcp --profile full 维护者模式。插件只用 mcp 启动服务，即上文所述的四工具配置；插件不会调用其他内容。这些功能是为手动运行该文件的用户准备的。
• 这里的“记忆”指什么。 指磁盘上的你自己的文件：CLAUDE.md、它导入的文件，以及 Claude Code 为项目保留的记忆文件夹；只有你将工具指向这些文件时，才会读取它们。插件绝不会读取聊天记录、对话摘要或上传的文件。

先用示例试试

此文件夹中的 examples/CLAUDE.md 是一个虚构项目的记忆文件。将它复制到一个空文件夹中，在该文件夹内打开 Claude Code，然后说“用 minnimemory 整理我的记忆”，接着说“应用它”，再说“撤销记忆编译”。这样就完成了整个流程，而且操作的是一个不会造成损坏的文件。

安全问题报告

请将漏洞报告发送至 [email protected]，或在此代码库中提交 GitHub issue；维护者会查看这两种方式。该插件不会发起网络调用，因此大多数报告会与它在磁盘上读取或写入的内容有关。

• 写入内容及位置。 在你的 Claude 配置文件夹下（除非 CLAUDE_CONFIG_DIR 另有指定，否则为 ~/.claude）：minnimemory/discovery.json（记忆加载位置，由 init 写入）、minnimemory/loads/<project>.jsonl（加载日志）、minnimemory/hook-sessions/<session>.json（提示词钩子已添加的章节），以及 minnimemory/undo-backups/（强制撤销所丢弃内容的副本）。在已编译的项目或记忆文件夹中：.minnimemory/ 存放 apply 命令创建的备份和一个简短的漂移标记。服务本身绝不会写入记忆文件。
• 不会向任何地方发送内容。 插件不会发起网络请求、调用模型或收集数据。它从你的会话中读取的唯一数据，是钩子用于匹配记忆的提示词文本；这些文本不会被存储。

故障排查

• 每次提示词都会显示“hook failed to start”，或服务无法连接。 Node 未安装，或不在 Claude Code 可见的 PATH 中。请安装 Node 18.3 或更高版本；从桌面启动器启动的 Claude Code 可能需要在安装后重启，才能获取新的 PATH。
• 提示词 hook 从不添加任何内容。 只有在与提示词明显匹配、放入内容的成本低于读取内容的成本，且内容尚未包含在始终加载的正文中时，才会添加章节。如果记忆内容很少或尚未编译，就没有可添加的内容；请先运行 init 和 apply。
• 出现两个名为 minnimemory 的服务。 你同时安装了 npx 版本和插件。运行 npx -y minnimemory uninstall，然后重启 Claude Code。
• apply 提示计划哈希不匹配。 预览后记忆文件发生了变化。请运行 doctor 生成最新计划，然后再次运行 apply。

问题反馈：https://github.com/MinniAI-com/minnimemory-plugin/issues。文档：https://minniai.com/minnimemorymcp/docs。

更新

在 /plugin 中为 minniai marketplace 启用自动更新，或运行 claude plugin update minnimemory@minniai。新版本会在下次启动时加载， 也可以在运行 /reload-plugins 后加载。

公司管理员： 如果所有机器都必须运行相同版本，请关闭自动更新，并在托管设置中固定版本。

移除

claude plugin uninstall minnimemory@minniai。已编译的记忆会保持编译状态； 如果想恢复原始内容，请先运行 undo。<config>/minnimemory/ 下的小型记录也会保留； 如果不想留下任何内容，请删除该文件夹。

许可证

请参阅 LICENSE。server/ 中捆绑的第三方代码及其许可证列于 THIRD_PARTY_NOTICES.md 中。