mac-cleaner-mcp

公式のModel Context Protocol TypeScript SDKを通じて公開される、保守的なmacOS開発者向け/ストレージクリーナーです。完全なディスク最適化ツールではありません。まずレポートを出力し、広範囲に破壊的な場所を拒否し、ドライランをサポートします。

ツール

• scan_junk: DerivedData、iOS DeviceSupport、Gradle/Androidキャッシュ、Homebrewキャッシュ、Nodeパッケージキャッシュ、Dockerの再利用可能なスペース、~/Library/Caches、大きなDownloadsファイル（>100 MB）、および検出されたnode_modules。

• clean_junk: カテゴリを受け入れ、デフォルトはdryRun: trueです。クリーンアップできるのはDerivedData、DeviceSupport、Android/Gradle、Homebrew、Dockerのみです。Downloads、node_modules、および広範囲のキャッシュルートは意図的に拒否されます。

• get_disk_usage: 選択したパスに対してdfを実行します。

Related MCP server: cacheout-mcp

インストールと実行

macOS、Node.js 20+、およびオプションでDockerが必要です。rootとして実行しないでください。

git clone https://github.com/FFFames/mac-cleaner-mcp.git
cd mac-cleaner-mcp
npm install
npm run build
node dist/index.js

MCPはstdioを使用するため、プロセスはMCPクライアントによって起動される必要があります。クリーンアップはファイルを削除する可能性があります。dryRun: falseを設定する前に、ドライランの出力を確認し、バックアップを保持してください。

Claude Desktop / Cursor

クライアントのMCP設定にdist/index.jsへの絶対パスを追加します:

{"mcpServers":{"mac-cleaner":{"command":"node","args":["/ABSOLUTE/PATH/mac-cleaner-mcp/dist/index.js"]}}}

クライアントを再起動し、scan_junkを呼び出し、次に選択したカテゴリとdryRun: trueでclean_junkを呼び出します。結果を確認した後でのみfalseを使用してください。CursorはそのMCP設定を通じて同じstdio MCPサーバー構成をサポートしています。

Poke / リモートブリッジ

ローカルのPoke互換ブリッジの場合、このサーバーを子プロセスとして実行し、認証されたHTTPSエンドポイントを介してMCP JSON-RPCのstdin/stdoutをプロキシします。簡単なオプションは、SSH/HTTPブリッジまたは独自のブリッジプロセスの前にngrokを使用することです:

ngrok http 8787

ブリッジのアップストリームコマンドをnode /ABSOLUTE/PATH/mac-cleaner-mcp/dist/index.jsとして設定し、HTTPSのngrok URLをPoke/MCP接続に登録します。認証されていないエンドポイントを公開しないでください。ngrokの認証トークンを使用し、呼び出し元を許可リストに登録し、URL/トークンをローテーションしてください。クリーナー自体はローカルのみで、ネットワークリスナーはありません。

安全性

実装は明示的なカテゴリ許可リストを使用し、シェルのワイルドカード展開は行わず、デフォルトでドライランを実行し、Downloads、node_modules、およびユーザーキャッシュルート全体を拒否します。使用前にソースを確認し、重要でないアカウントでテストしてください。