Disk Clean

Disk Clean MCP Server

日本語 | 英語

Claude や他の AI アシスタントに「ディスクをクリーンアップして」と頼んでみましょう。この MCP サーバーは、ディスク容量を圧迫しているファイルを見つけ、ゴミ箱に移動します。

• 削除されるものはありません。項目は OS のゴミ箱に移動するため、後で復元できます
• まず必ず一覧が表示され、承認した項目だけが移動されます
• システムフォルダーには触れません

対応 OS：macOS／Linux／Windows

検出対象

種類	例
開発者向けキャッシュ	node_modules、__pycache__、Rust の target/、build/ と dist/、Python 仮想環境（.venv）、~/.gradle/caches、~/.cargo/registry
サイズが大きく、使われていない動画	.mp4、.mov、.mkv など、100 MB を超え、90 日間開かれず、変更もされていない動画
古いログ	30 日間更新されていない .log および .log.gz ファイル

依頼時にサイズや経過期間の制限を変更できます（たとえば「500 MB を超える動画」や「1 年以上前のログ」）。

---

インストール

Claude Desktop（最も簡単）

1. Releasesから最新の diskclean-mcp-server-*.mcpb をダウンロードします
2. ファイルをダブルクリックするか、Claude Desktop の Settings → Extensions にドラッグします
3. Install をクリックします

Claude Desktop が Python などの必要なものをすべてセットアップします。

その他のアプリ（Claude Code、Cline、手動セットアップ）

これらのアプリでは、uv を使用してサーバーをダウンロードし、実行します。Python を自分でインストールする必要はありません。

ステップ 1. uv をインストールする

macOS／Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

新しいターミナルを開き、uv --version が動作することを確認します。

ステップ 2. アプリにサーバーを追加する

Claude Code

claude mcp add --scope user diskclean -- uvx diskclean-mcp-server

--scope user を指定すると、すべてのプロジェクトで利用できるようになります。

任意：Claude に安全なクリーンアップ手順を教えるスキルをインストールします。

mkdir -p ~/.claude/skills/disk-cleanup
curl -fsSL https://raw.githubusercontent.com/Kate941-su/diskcleaner-mcp/main/.claude/skills/disk-cleanup/SKILL.md \
  -o ~/.claude/skills/disk-cleanup/SKILL.md

Claude Desktop（手動セットアップ）

設定ファイルを開きます：

OS	設定ファイル
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

以下を追加し、Claude Desktop を再起動します：

{
  "mcpServers": {
    "diskclean": {
      "command": "uvx",
      "args": ["diskclean-mcp-server"]
    }
  }
}

Cline（VS Code）

Cline の MCP Servers 画面から設定ファイルを開き、上記と同じエントリーを追加します。

---

使い方

アシスタントに普通の言葉で頼みます：

My disk is full. Find files I don't need in my home folder.

Clean up all the node_modules folders under ~/projects.

Find videos in ~/Movies over 1 GB that I haven't watched in six months.

Show me what is using space in ~/Library/Caches, two levels deep.

実行内容

1. アシスタントがフォルダーを調べ、容量を使用しているものを伝えます
2. 候補の一覧（パス、種類、サイズ、最終更新日時）と、解放できる容量の合計が表示されます。この時点では何も移動されていません
3. 移動するものを伝えます（「すべて」「node_modules だけ」「#3 以外すべて」など）
4. 承認された項目だけがゴミ箱に移動され、結果が報告されます

ファイルの復元

すべてゴミ箱に移動するため、いつでも元に戻せます。

• macOS：Finder でゴミ箱を開き、項目を右クリックして Put Back を選択します
• Windows：ごみ箱を開き、項目を右クリックして Restore を選択します
• Linux：ファイルマネージャーでゴミ箱を開き、Restore を選択します（~/.local/share/Trash に保存されます）

ディスク容量が実際に解放されるのは、ゴミ箱を空にしたときです。

移動されないもの

• OS のシステムフォルダー（/usr、/System、C:\Windows、C:\Program Files など）
• ホームフォルダー自体、およびディスクのルート直下にあるフォルダー
• 表示された一覧に含まれていないもの
• シンボリックリンク（およびリンク先のファイル）
• プロジェクトではなく、ツールやアプリに属する node_modules や仮想環境：pnpm ストア、nvm でインストールされた Node.js、VS Code 拡張機能、~/Library、~/AppData、またはホームフォルダー内の隠しフォルダーにあるもの。これらを削除すると、ツールが動作しなくなります

build/ と dist/ は、隣に package.json などのビルドファイルがある場合にのみキャッシュとして扱われるため、同じ名前の通常のフォルダーが誤って検出されることはありません。

---

更新

Claude Desktop 拡張機能の場合：Releases から新しい .mcpb をダウンロードして、再度インストールしてください。

uvx の場合：uv はキャッシュしたコピーを使用します。最新バージョンを取得するには、以下を実行してアプリを再起動してください。

uv cache clean diskclean-mcp-server

常に最新バージョンを起動するには、代わりに "args": ["diskclean-mcp-server@latest"] を使用してください。サーバーの起動ごとに更新を確認します。

---

トラブルシューティング

ツールがアシスタントに表示されない場合

• 設定を変更した後、アプリを再起動してください
• Claude Desktop が uvx を見つけられない場合があります。which uvx（macOS / Linux）または where uvx（Windows）で確認したフルパスを "command" に指定してください
• Claude Code では、claude mcp list で確認してください

「一部のフォルダーを読み込めませんでした」（skipped_errors）

• 読み取り権限のないフォルダーはスキップされます。macOS では、アプリにフルディスクアクセスを許可すると解決する場合があります（システム設定 → プライバシーとセキュリティ）

スキャンが早期に停止した場合（timed_out）

• 1 回のスキャンは最大 60 秒間実行されます。~/projects のような、より小さいフォルダーを指定してください

---

開発者向け

設計、ツールの仕様、開発環境のセットアップ、リリース手順については、docs/DESIGN.md を参照してください（日本語）。

ライセンス

MIT