mcp-folder-scout

Claude に、フォルダの中身、古くなったファイル、そして容量がどこに消えたのかを尋ねてください。

このツールは、あなたのマシン上の1つのフォルダを対象に、名前・サイズ・日付を報告します。ファイルの中身を読むことはできませんし、移動や削除もできません。

> 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 を共有するファイルは1回だけ数えるため、合計が倍増することはありません。ただし、クローンの1コピーを削除しても、表示されているサイズ分の空き領域は増えない場合があります。

スキャンはデフォルトで50,000ファイルで停止し、階層は3レベルまで降下します。結果は5分間キャッシュされます。強制的に再スキャンするには refresh を渡します。

スクリーンショットの山やほぼ同じ画像の検出はまだ行われていません。完全一致の重複検出は計画中です。

ライセンス

MIT