Disk Space Monitor — Servidor MCP

Un pequeño servidor Model Context Protocol que permite a un asistente de IA inspeccionar el uso del disco en la máquina en la que se ejecuta. Dirige Claude Desktop (o cualquier cliente MCP) hacia él y podrás preguntar "¿Se me está llenando el disco?" y obtener una respuesta real en lugar de una suposición.

Multiplataforma (Windows / macOS / Linux), sin archivos de configuración, sin acceso a red y sin telemetría.

Herramientas

Niveles de estado

Related MCP server: Hardware Monitor MCP Server

Ejemplo de salida

disk_summary()

🟢 ALL GOOD — All partitions below 50.0%. System is healthy.

check_single_path("C:\\")

💽  DISK USAGE: C:\
    Windows 11  │  2026-08-17 19:08:44  │  Threshold: 50.0%
─────────────────────────────────────────────────────────────────
  Status  : 🟠 WARNING
  Usage   : [██████████████░░░░░░░░] 63.4%
  Used    :    301.2 GB
  Free    :    173.8 GB
  Total   :    475.0 GB
─────────────────────────────────────────────────────────────────
⚠️  Above 50.0%. Consider archiving old files or clearing caches.

check_disk_space(threshold=70)

💽  DISK SPACE REPORT
    Windows 11  │  2026-08-17 19:08:44  │  Threshold: 70.0%
─────────────────────────────────────────────────────────────────
  🟢 OK        C:\  [NTFS]
           [██████████████░░░░░░░░] 63.4%
           Used     301.2 GB  │  Free     173.8 GB  │  Total     475.0 GB

  🔴 CRITICAL  D:\  [NTFS]
           [████████████████████░░] 92.7%
           Used     927.0 GB  │  Free      73.0 GB  │  Total    1000.0 GB
─────────────────────────────────────────────────────────────────
⚠️  1 critical, 0 warning:
   🔴 D:\ (92.7%)

Requisitos

• Python 3.10 o superior (desarrollado con 3.12)

• mcp y psutil

Instalación

git clone https://github.com/<your-username>/disk-space-monitor.git
cd disk-space-monitor

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate

pip install -r requirements.txt

Cómo conectarlo a Claude Desktop

Añade el servidor a tu archivo de configuración de Claude Desktop:

• Windows — %APPDATA%\Claude\claude_desktop_config.json

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "disk-monitor": {
      "command": "/absolute/path/to/disk-space-monitor/.venv/bin/python",
      "args": ["/absolute/path/to/disk-space-monitor/main.py"]
    }
  }
}

En Windows las rutas tienen este aspecto: C:/path/to/disk-space-monitor/.venv/Scripts/python.exe y C:/path/to/disk-space-monitor/main.py. Ambas rutas deben ser absolutas — el servidor se lanza directamente, no mediante un shell.

Reinicia Claude Desktop después. Las tres herramientas aparecen automáticamente y puedes hacer preguntas como:

¿Se está llenando mi disco? Comprueba la unidad D: y avísame si supera el 80 %. Dame un resumen de salud del disco en una sola línea.

Ejecutarlo de forma independiente

python main.py

El servidor se comunica a través de stdio mediante el protocolo MCP, por lo que ejecutarlo directamente simplemente se queda a la espera de un cliente — eso es lo esperado, no un bloqueo.

Cómo funciona

Detección de particiones. psutil.disk_partitions(all=False) enumera las particiones reales montadas; a continuación se omiten los pseudosistemas de archivos que suelen bloquearse o no aportan datos de uso significativos: squashfs, tmpfs, devtmpfs, overlay, autofs y las entradas sin tipo de sistema de archivos.

Protección contra tiempos de espera. Cada partición se lee dentro de un hilo demonio con un plazo de 0,5 segundos. Una unidad de red desconectada o un disco externo en reposo pueden hacer que shutil.disk_usage() se bloquee durante mucho tiempo; si se supera el plazo, la partición se notifica como ⚪ SKIPPED y el escaneo continúa. Así se evita que un solo montaje problemático congele toda la llamada a la herramienta.

Formato. Los tamaños se muestran en GB por debajo de 1000 GB y en TB a partir de esa cifra. La barra de uso tiene 22 caracteres de ancho y se limita a ese rango, de modo que los porcentajes malformados no pueden producir una salida descontrolada.

Estructura del proyecto

disk-space-monitor/
├── main.py            # the entire server — helpers + three tools
├── requirements.txt   # mcp, psutil
├── .gitignore
├── LICENSE
└── README.md

Privacidad

El servidor solo lee cifras locales de uso del disco —total, usado y libre en bytes por partición—, además del nombre y la versión del sistema operativo para la cabecera del informe. No realiza solicitudes de red, no escribe archivos, no lee contenidos de archivos y no almacena nada entre llamadas.

Licencia

MIT — consulta LICENSE.