mac-cleaner-mcp

Un limpiador conservador de almacenamiento/desarrollador de macOS expuesto a través del SDK oficial de TypeScript del Model Context Protocol. No es un optimizador completo de disco: primero informa, rechaza ubicaciones destructivas amplias y admite ejecuciones de prueba (dry runs).

Herramientas

• scan_junk: DerivedData, DeviceSupport de iOS, caché de Gradle/Android, caché de Homebrew, caché de paquetes de Node, espacio reclamable de Docker, ~/Library/Caches, archivos grandes de Descargas (>100 MB) y node_modules descubiertos.

• clean_junk: acepta categorías y por defecto tiene dryRun: true. Solo se pueden limpiar DerivedData, DeviceSupport, Android/Gradle, Homebrew y Docker. Descargas, node_modules y raíces de caché amplias se rechazan intencionalmente.

• get_disk_usage: ejecuta df para una ruta seleccionada.

Related MCP server: cacheout-mcp

Instalación y ejecución

Requiere macOS, Node.js 20+ y opcionalmente Docker. No lo ejecutes como 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 usa stdio, por lo que el proceso debe ser lanzado por el cliente MCP. La limpieza puede eliminar archivos; inspecciona la salida de la ejecución de prueba (dry-run) y mantén copias de seguridad antes de establecer dryRun: false.

Claude Desktop / Cursor

Añade la ruta absoluta a dist/index.js en la configuración MCP del cliente:

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

Reinicia el cliente, llama a scan_junk, luego llama a clean_junk con las categorías seleccionadas y dryRun: true. Usa false solo después de revisar el resultado. Cursor admite la misma configuración de servidor MCP stdio a través de sus ajustes MCP.

Poke / puente remoto

Para un puente local compatible con Poke, ejecuta este servidor como un proceso hijo y proxya el stdin/stdout de MCP JSON-RPC a través de un endpoint HTTPS autenticado. Una opción simple es un puente SSH/HTTP o ngrok delante de tu propio proceso de puente:

ngrok http 8787

Configura el comando ascendente del puente como node /ABSOLUTE/PATH/mac-cleaner-mcp/dist/index.js, luego registra la URL HTTPS de ngrok con tu conexión Poke/MCP. Nunca expongas un endpoint no autenticado; usa un token de autenticación de ngrok, permite solo a llamadores específicos y rota la URL/token. El limpiador en sí es solo local y no tiene listener de red.

Seguridad

La implementación utiliza listas de permitidos de categorías explícitas, sin expansión de comodines de shell, ejecución de prueba (dry-run) por defecto, y rechaza Descargas, node_modules y toda la raíz de caché del usuario. Revisa el código fuente y prueba en una cuenta no crítica antes de usarlo.