diskcleankit-mcp

DiskCleanKit MCP サーバー

Claude などの AI アシスタントが、Mac のディスククリーニング用に DiskCleanKit の One Touch 機能を操作できるようにする MCP（Model Context Protocol）サーバーです。

前提条件

• macOS
• DiskCleanKit アプリがインストールされていること
• Node.js v18+

インストール

npm 経由（推奨）

npm install -g @vannamtran/diskcleankit-mcp

ソースから

git clone https://github.com/namtran/diskcleankit-mcp
cd diskcleankit-mcp
npm install
npm run build

設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

その後、Claude Desktop を再起動します。

Claude Code（CLI）

claude mcp add --transport stdio diskcleankit -- npx @vannamtran/diskcleankit-mcp

または、~/.claude/settings.json を編集します。

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト固有）に追加します。

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

または、Cursor Settings → Tools & Integrations → New MCP Server に移動します。

VS Code（GitHub Copilot）

settings.json に追加します。

{
  "mcp.servers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

その他の MCP クライアント

クライアント	設定ファイル
Cline	VS Code 拡張機能の設定
Windsurf	~/.windsurf/mcp.json
Zed	~/.config/zed/settings.json
Continue	~/.continue/config.json

同じ設定構造を使用します。

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

Ollama（mcphost 経由）

Ollama は MCP をネイティブでサポートしていませんが、mcphost を使用できます。

pip install mcphost
mcphost -m ollama:qwen2.5 --config config.json

非対応

• ChatGPT：ネイティブの MCP サポートはありません

利用可能なツール

ツール	説明
one_touch_scan	ジャンクファイルをスキャンします（安全、削除は行いません）
one_touch_clean	推奨 - ジャンクファイルをスキャンして自動的にクリーンアップします
get_disk_status	ディスク容量と健全性の状態を確認します
get_cleanable_estimate	カテゴリごとにクリーンアップ可能な容量を推定します
get_cleaning_history	過去のクリーニングセッションを表示します

クリーンアップされるもの

one_touch_clean は、安全な項目のみを自動的にスキャンしてクリーンアップします。

カテゴリ	説明
システムキャッシュ	macOS のシステムキャッシュファイル
アプリケーションキャッシュ	アプリが生成したキャッシュファイル
アプリケーションログ	アプリの古いログファイル
ブラウザーキャッシュ	Safari、Chrome、Firefox のキャッシュ

これらはすべて安全に削除でき、必要に応じてシステムやアプリによって再生成されます。

使用例

設定が完了したら、AI アシスタントに次のように依頼します。

• 「Mac のジャンクファイルをスキャンして」→ one_touch_scan
• 「Mac をクリーンアップして」→ one_touch_clean
• 「ディスク容量はどれくらいある？」→ get_disk_status
• 「何をクリーンアップできる？」→ get_cleanable_estimate
• 「クリーニング履歴を表示して」→ get_cleaning_history

仕組み

AI Assistant → MCP Server → URL Scheme → DiskCleanKit App
                   ↑                            ↓
              JSON Response ← Temp File ← Response

1. AI が MCP サーバーのツールを呼び出します
2. MCP サーバーが diskcleankit:// URL スキームを介して DiskCleanKit を起動します
3. DiskCleanKit がリクエストを処理し、応答を /tmp/diskcleankit_mcp_response.json に書き込みます
4. MCP サーバーが応答を読み取り、AI に返します

セキュリティ

• one_touch_scan は安全です。スキャンのみを行い、削除はしません
• one_touch_clean は安全な項目（キャッシュとログのみ）を自動的にスキャンしてクリーンアップします
• 再生成可能なファイルのみをクリーンアップします。個人データや書類には一切触れません
• すべての処理は Mac 上でローカルに行われます
• 外部サーバーにデータは送信されません

注： one_touch_clean はそのまま実行しても安全です。自動的に再生成されるシステムやアプリのキャッシュとログのみを削除します。

トラブルシューティング

「Timeout waiting for response」

• DiskCleanKit アプリがインストールされていることを確認してください
• まず DiskCleanKit を手動で開いてみてください

Claude にサーバーが表示されない

• 設定パスが正しいことを確認してください
• 設定を変更した後、Claude Desktop を再起動してください
• Claude のログでエラーを確認してください

ライセンス

MIT

リンク

• DiskCleanKit アプリ
• MCP プロトコル