mcp-folder-scout

Pregunta a Claude qué hay en una carpeta, qué se ha quedado obsoleto y a dónde ha ido a parar el espacio.

Apunta a una carpeta de tu máquina e informa de nombres, tamaños y fechas. No puede leer el contenido de los archivos ni puede mover o eliminar nada.

> What's in my Downloads folder, and what haven't I opened in over a year?

771 files, 43.0 GB. Video is 96% of it.

Not opened in over a year: 102 files, 15.3 GB, almost all of it
video — Barclay lake (27 clips, ~12 GB) and Big (2 clips, 2.5 GB).
If those are backed up elsewhere, they're the obvious candidates.

76 files matched identity, legal, tax, or medical naming and were
excluded from the suggestions above.

Instalación

claude mcp add --scope user folder-scout -- uvx mcp-folder-scout

Para Claude Desktop, añade esto a claude_desktop_config.json y reinicia:

{
  "mcpServers": {
    "folder-scout": {
      "command": "uvx",
      "args": ["mcp-folder-scout"]
    }
  }
}

El archivo de configuración se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS y en %APPDATA%\Claude\claude_desktop_config.json en Windows.

Requiere uv y Python 3.10+. Funciona con cualquier cliente MCP.

Related MCP server: mcp-doc-search

Herramientas

Ambas devuelven únicamente metadatos.

Lo que no hará

No puede eliminar, mover ni renombrar nada. No hay ninguna ruta de escritura en el código. Las sugerencias van dirigidas a ti; las ejecutas tú mismo en Finder.

No puede leer tus archivos. Solo los nombres, los tamaños y las marcas de tiempo salen de tu máquina.

No recomendará eliminar tus documentos. Los archivos y carpetas cuyo nombre coincide con denominaciones de identidad, legales, fiscales o médicas (pasaporte, visado, W2, seguro, matrimonio, escritura, etc.) se contabilizan en los totales y se marcan, pero nunca se ofrecen como candidatos de limpieza. Esa protección se hereda a los niveles inferiores, así que un archivo llamado scan1.pdf dentro de Passport Renewal/ también está cubierto.

Las carpetas sincronizadas con la nube (iCloud, Dropbox, OneDrive) se omiten en lugar de procesarse, porque sus tamaños y marcas de tiempo no tienen sentido en el disco. También se omiten las carpetas del sistema, los paquetes de aplicaciones y los directorios de compilación. Cada escaneo informa de lo que se ha excluido.

Limitaciones conocidas

La fecha del último acceso es una pista, no un dato fidedigno. Spotlight, los backups y el antivirus pueden modificarla, y algunos volúmenes pueden dejar de registrarla por completo. Cuando el servidor detecta que los tiempos de acceso no se están manteniendo, lo comunica y recurre a las fechas de modificación.

«Antiguo y sin tocar» describe los registros fiscales archivados con la misma precisión que la basura. Ese es el propósito de la lista protegida, y no lo atrapará todo. Revisa antes de eliminar.

Los clones APFS y los enlaces físicos (hard links) comparten bloques en el disco. Los archivos que comparten inodo se cuentan una sola vez, por lo que los totales no se duplican; sin embargo, eliminar una copia de un archivo clonado puede liberar menos espacio que el indicado en su tamaño.

Los escaneos se detienen en 50 000 archivos y descienden tres niveles por defecto. Los resultados se almacenan en caché durante cinco minutos; pasa refresh para forzar un nuevo escaneo.

Los montones de capturas de pantalla y las imágenes casi duplicadas aún no se detectan. La detección de duplicados exactos está prevista.

Licencia

MIT