mcp-folder-scout

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 クライアントで動作します。

ツール

ツール	機能
scan_folder	フォルダーの概要：種類別の内訳、経過期間別の区分、容量の大きいサブフォルダー。
list_files	経過期間、サイズ、種類、サブフォルダーで絞り込んだ個別のファイル。

どちらもメタデータのみを返します。

できないこと

何かを削除、移動、または名前変更することはできません。 コードに書き込み処理はありません。提案はあなたに提示されます。Finder でご自身で操作してください。

ファイルを読み取ることはできません。 マシンの外部に送信されるのは、名前、サイズ、タイムスタンプのみです。

書類の削除を推奨することはありません。 パスポート、ビザ、W2、保険、結婚、権利証など、身分証明、法律、税金、医療に関する名前を持つファイルやフォルダーは、合計には含めてマークしますが、整理候補として提示することはありません。この保護は下位の階層にも引き継がれるため、Passport Renewal/ 内の scan1.pdf も保護されます。

iCloud、Dropbox、OneDrive などのクラウド同期フォルダーは、ディスク上のサイズやタイムスタンプに意味がないため、処理せずスキップします。システムフォルダー、アプリケーションバンドル、ビルドディレクトリもスキップします。各スキャンでは、除外した項目が報告されます。

既知の制限

最終アクセス時刻はあくまで目安であり、正確な値とは限りません。Spotlight、バックアップ、ウイルス対策ソフトはいずれもアクセス時刻を更新することがあり、アクセス時刻の記録を完全に停止するボリュームもあります。サーバーがアクセス時刻が維持されていないことを検出すると、その旨を知らせ、代わりに更新日時を使用します。

古くて手つかずのファイルは、不要なファイルだけでなく、保管された税務記録にも当てはまります。そのために保護リストがありますが、すべてを検出できるわけではありません。削除する前に確認してください。

APFS のクローンとハードリンクは、ディスク上のブロックを共有します。同じ inode を共有するファイルは1回だけ数えるため、合計が重複することはありませんが、クローンファイルのコピーを1つ削除しても、表示されているサイズ分の容量が空くとは限りません。

スキャンはファイル数が50,000件に達すると停止し、デフォルトでは3階層までたどります。結果は5分間キャッシュされます。再スキャンを強制するには refresh を渡してください。

スクリーンショットの大量保存や、ほぼ同一の画像はまだ検出されません。完全一致する重複ファイルの検出は今後実装予定です。

ライセンス

MIT

mcp-name: io.github.dharani0804/mcp-folder-scout

mcp-name: io.github.dharani0804/mcp-folder-scout