Rootz Archive MCP Server已验证已精选

什么是 Rootz Archive MCP Server？

Rootz Archive MCP Server 是 Claude Code 插件 Rootz Archive 的搜索部分。该插件会在你自己的电脑上精确保存每一段对话以及 Claude 编辑过的每个文件的副本，服务器则让你的 AI 能够搜索这些内容。个人用户免费，无需账号，可离线使用。

Claude Code 默认会在 30 天后清理旧会话。Rootz Archive 保留一份逐字节一致的记录，不受这次清理影响，其中包括 Claude 压缩之前的对话内容、子智能体对话以及 Claude 编辑过的文件。名为 archive-free 的本地 stdio MCP 服务器提供 13 个用于搜索、回忆、摘要和状态的工具。插件不建立任何网络连接，Rootz 收不到任何数据。它由 Rootz Corp 开发，已以 global.rootz/archive 收录在官方 MCP Registry 中。使用受 Rootz Archive Use Licence 约束，并非开源许可。

如何使用 Rootz Archive MCP Server？

前提条件：Node.js 22.13 或更高版本（用 node -v 检查）。已在 macOS 上测试，Windows 和 Linux 仍在测试中。

Claude Code（完整采集与搜索）

claude plugin marketplace add rootz-global/rootz-archive
claude plugin install rootz-archive@rootz

开启一个新的 Claude Code 会话，输入 /rootz-archive:accept 接受许可。在此之前不会采集任何内容。之后每个会话开始时都会显示一行状态，说明上次采集的时间和已归档的数量。插件会自动注册其 MCP 服务器，无需另外编写 MCP 配置。

在 Windows 上，如果 claude plugin marketplace add 报错 EBUSY: resource busy or locked，请把仓库克隆到本地文件夹，并把该文件夹添加为 marketplace：

git clone https://github.com/rootz-global/rootz-archive C:\rootz-plugins\rootz-archive
claude plugin marketplace add C:\rootz-plugins\rootz-archive
claude plugin install rootz-archive@rootz

Claude Desktop（仅搜索）

从 最新发布 下载 rootz-archive-<version>.mcpb，用 Claude Desktop 打开。然后进入 Settings → Extensions → Rootz Archive，勾选 “I accept the Rootz Archive Use Licence”。Desktop 可以搜索由 Claude Code 插件建立的归档，但持续采集需要插件。

Cursor、VS Code 及其他 AI 工具

插件会在 ~/.rootz-archive/bin/archive-free-mcp.mjs 安装一个启动器，让同一台电脑上的其他 AI 工具也能搜索归档。README 没有给出对应的客户端配置。用 Node 运行该启动器的 stdio 条目大致如下（请换成你自己的主目录路径）：

{
  "mcpServers": {
    "rootz-archive": {
      "command": "node",
      "args": ["/Users/you/.rootz-archive/bin/archive-free-mcp.mjs"]
    }
  }
}

Rootz Archive MCP Server 的主要功能

• 精确复制 ~/.claude/projects（对话记录、子智能体记录、工具结果、记忆）、~/.claude/file-history 和 ~/.claude/history.jsonl，以 gzip 存储并按 SHA-256 命名。
• PreCompact 钩子会在 Claude 压缩对话之前先做一次快照。
• 每天按指纹重新校验每份副本，Rootz Archive 自身从不删除任何内容。
• 文件仅你本人可读（文件夹 0700，文件 0600），从不复制设置、凭证或缓存。
• 搜索索引使用带 FTS5 全文检索的 SQLite，与 Rootz Desktop 共用。
• 你的 AI 可以用你自己的 Claude 账号为过去的会话生成摘要并加入搜索，Archive 从不持有 AI 密钥。
• 每条回答都标注 “Source: Rootz Archive · this computer”。

Rootz Archive MCP Server 的使用场景

• 回忆决策：“我们上个月对登录流程做了什么决定？”
• 查找修复：“找到我们修复上传 bug 的那次会话。”
• 检查状态：“Rootz Archive 在正常工作吗？”
• 生成摘要：“为我最长的五个还没有摘要的会话生成摘要。”
• 带凭证分享：输入 /rootz-archive:share，或让 Claude 通过 share_session 工具分享某段对话。它会在本地生成一个包含对话和签名采集凭证的文件夹，接收方在 receipts.rootz.global/verify 上校验。

Rootz Archive MCP Server 常见问题排查

• 没有采集任何内容：你还没有运行 /rootz-archive:accept，或者没有安装 Node.js 22.13 及以上版本。会话开始时的状态行会提示是否未在归档。
• 某个项目不应被归档：在该文件夹中运行 /rootz-archive:exclude-project，已生成的副本会保留，直到你删除。用 /rootz-archive:pause 和 /rootz-archive:resume 暂停和恢复采集。
• Windows 安装报 EBUSY：按上文方法从本地克隆安装。
• 想全部清除：先卸载插件（claude plugin uninstall rootz-archive 和 claude plugin marketplace remove rootz），再删除 ~/.rootz-archive/ 以及 FORMAT.md 中列出的文件。