mac-cleaner-mcp

Ein konservativer macOS-Entwickler-/Speicher-Cleaner, der über das offizielle Model Context Protocol TypeScript SDK bereitgestellt wird. Es ist kein vollständiger Festplatten-Optimierer: Es meldet zuerst, verweigert breite destruktive Speicherorte und unterstützt Dry Runs.

Werkzeuge

• scan_junk: DerivedData, iOS DeviceSupport, Gradle/Android-Cache, Homebrew-Cache, Node-Paket-Cache, Docker-freigebbarer Speicherplatz, ~/Library/Caches, große Downloads-Dateien (>100 MB) und gefundene node_modules.

• clean_junk: akzeptiert Kategorien und standardmäßig dryRun: true. Nur DerivedData, DeviceSupport, Android/Gradle, Homebrew und Docker können bereinigt werden. Downloads, node_modules und breite Cache-Wurzeln werden absichtlich verweigert.

• get_disk_usage: führt df für einen ausgewählten Pfad aus.

Related MCP server: cacheout-mcp

Installation und Ausführung

Erfordert macOS, Node.js 20+ und optional Docker. Nicht als Root ausführen.

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

MCP verwendet stdio, daher sollte der Prozess vom MCP-Client gestartet werden. Das Bereinigen kann Dateien löschen; überprüfen Sie die Dry-Run-Ausgabe und erstellen Sie Backups, bevor Sie dryRun: false setzen.

Claude Desktop / Cursor

Fügen Sie den absoluten Pfad zu dist/index.js in der MCP-Konfiguration des Clients hinzu:

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

Starten Sie den Client neu, rufen Sie scan_junk auf, dann clean_junk mit ausgewählten Kategorien und dryRun: true. Verwenden Sie false erst nach Überprüfung des Ergebnisses. Cursor unterstützt dieselbe stdio-MCP-Serverkonfiguration über seine MCP-Einstellungen.

Poke / Remote-Brücke

Für eine lokale Poke-kompatible Brücke führen Sie diesen Server als untergeordneten Prozess aus und leiten Sie MCP-JSON-RPC stdin/stdout über einen authentifizierten HTTPS-Endpunkt weiter. Eine einfache Option ist eine SSH/HTTP-Brücke oder ngrok vor Ihrem eigenen Brückenprozess:

ngrok http 8787

Konfigurieren Sie den Upstream-Befehl der Brücke als node /ABSOLUTE/PATH/mac-cleaner-mcp/dist/index.js und registrieren Sie dann die HTTPS-ngrok-URL mit Ihrer Poke/MCP-Verbindung. Setzen Sie niemals einen nicht authentifizierten Endpunkt ein; verwenden Sie ein ngrok-Auth-Token, erlauben Sie nur bestimmte Aufrufer und rotieren Sie URL/Token. Der Cleaner selbst ist nur lokal und hat keinen Netzwerk-Listener.

Sicherheit

Die Implementierung verwendet explizite Kategorie-Allowlists, keine Shell-Wildcard-Expansion, standardmäßig Dry-Run und verweigert Downloads, node_modules und die gesamte Benutzer-Cache-Wurzel. Überprüfen Sie den Quellcode und testen Sie ihn vor der Verwendung auf einem nicht kritischen Konto.