mcp-folder-scout

向 Claude 询问一个文件夹里有什么、哪些内容已经过时，以及空间都用在了哪里。

它指向你机器上的一个文件夹，并报告名称、大小和日期。它无法读取文件内容，也无法移动或删除任何内容。

> What's in my Downloads folder, and what haven't I opened in over a year?

771 files, 43.0 GB. Video is 96% of it.

Not opened in over a year: 102 files, 15.3 GB, almost all of it
video — Barclay lake (27 clips, ~12 GB) and Big (2 clips, 2.5 GB).
If those are backed up elsewhere, they're the obvious candidates.

76 files matched identity, legal, tax, or medical naming and were
excluded from the suggestions above.

安装

claude mcp add --scope user folder-scout -- uvx mcp-folder-scout

在 Claude Desktop 中，把下面这段加入 claude_desktop_config.json，然后重启：

{
  "mcpServers": {
    "folder-scout": {
      "command": "uvx",
      "args": ["mcp-folder-scout"]
    }
  }
}

配置文件位于 macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json 和 Windows 上的 %APPDATA%\Claude\claude_desktop_config.json。

需要 uv 和 Python 3.10+。适用于任何 MCP 客户端。

Related MCP server: mcp-doc-search

工具

两者都只返回元数据。

它不会做什么

它无法删除、移动或重命名任何内容。 代码里没有写入路径。它能做的只是向你提建议；具体操作需要你自己在 Finder 中完成。

它无法读取你的文件。 只有名称、大小和时间戳会离开你的电脑。

它不会建议删除你的文档。 凡文件或文件夹的名称涉及身份、法律、税务或医疗（例如护照、签证、W2、保险、结婚证、契约等），都会计入累计汇总并被标记，但永远不被视为清理候选。这种保护会向下继承，所以 Passport Renewal/ 里一个名为 scan1.pdf 的文件也会被覆盖到。

云同步文件夹（iCloud、Dropbox、OneDrive）会被跳过而不做处理，因为它们在磁盘上的大小和时间戳没有意义。系统文件夹、应用包和构建目录也同样会被跳过。每次扫描都会列出哪些内容被排除了。

已知限制

上次访问时间只是一个提示，不是确凿事实。Spotlight、备份和杀毒软件都可能使它变化，且某些卷甚至会完全停止记录访问时间。当服务器检测到访问时间并没有被维护时，它会明确说明，并回退为使用修改时间。

“很旧、从未动过”这个判断，用在归档的税务记录上，和用在垃圾文件上一样“准确”。这正是受保护列表发挥作用的地方，但它无法涵盖所有情况。删除前请务必自己确认。

APFS 克隆和硬链接在磁盘上共享数据块。凡是共享同一 inode 的文件只会被计数一次，因此汇总不会重复统计，但删除某个克隆文件的一个副本，实际释放的空间可能小于其列出的大小。

默认情况下，扫描在 50,000 个文件处停止，并只向下查看三层。结果会缓存 5 分钟；传入 refresh 可强制重新扫描。

截图堆积文件和近似重复图片暂时不会被检测。检测计划包括精确查重。

许可证

MIT