downloader-mcp

Un servidor MCP para clientes de descarga — SABnzbd (usenet) y qBittorrent (torrents) — empaquetado como un contenedor Docker. Complemento para MCPs de gestión de medios como servarr-mcp.

Cada cliente es opcional: configura solo los que realmente ejecutas, y solo esas herramientas se registrarán.

Herramientas

SABnzbd (usenet)

Herramienta	Descripción
`sabnzbd_queue`	Cola de descarga actual con velocidades y tiempos estimados
`sabnzbd_history`	Historial reciente (primero los más nuevos)
`sabnzbd_categories`	Categorías configuradas
`sabnzbd_version`	Información de la versión de SABnzbd

qBittorrent (torrents)

Herramienta	Descripción
`qbittorrent_list_torrents`	Listar torrents, filtro de estado opcional
`qbittorrent_get_torrent`	Detalles del torrent por info-hash
`qbittorrent_torrent_files`	Archivos dentro de un torrent
`qbittorrent_transfer_info`	Estadísticas globales de transferencia
`qbittorrent_categories`	Categorías configuradas
`qbittorrent_version`	Versión de la aplicación qBittorrent

Configuración

Cada cliente requiere su bloque de configuración completo para habilitarse; una configuración parcial desactiva el cliente silenciosamente.

Cliente	Variables de entorno requeridas	Puerto predeterminado
SABnzbd	`SABNZBD_URL`, `SABNZBD_API_KEY`	8080
qBittorrent	`QBITTORRENT_URL`, `QBITTORRENT_USERNAME`, `QBITTORRENT_PASSWORD`	8080

Las claves API / credenciales se encuentran en la configuración de cada aplicación:

SABnzbd: Config → General → API Key
qBittorrent: Tools → Options → Web UI (usuario predeterminado admin)

Nota: Tanto SABnzbd como qBittorrent usan el puerto 8080 por defecto. Si ejecutas ambos en el mismo host, reasigna uno de ellos en su propia configuración.

Al menos un cliente debe estar configurado o el servidor se cerrará con un error.

Ejecutar con Docker

docker build -t downloader-mcp .
docker run -i --rm \
  -e SABNZBD_URL=http://192.168.1.50:8080 -e SABNZBD_API_KEY=... \
  -e QBITTORRENT_URL=http://192.168.1.50:8081 \
  -e QBITTORRENT_USERNAME=admin -e QBITTORRENT_PASSWORD=... \
  downloader-mcp

Usar con Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "downloader": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SABNZBD_URL", "-e", "SABNZBD_API_KEY",
        "-e", "QBITTORRENT_URL",
        "-e", "QBITTORRENT_USERNAME", "-e", "QBITTORRENT_PASSWORD",
        "downloader-mcp"
      ],
      "env": {
        "SABNZBD_URL": "http://192.168.1.50:8080",
        "SABNZBD_API_KEY": "...",
        "QBITTORRENT_URL": "http://192.168.1.50:8081",
        "QBITTORRENT_USERNAME": "admin",
        "QBITTORRENT_PASSWORD": "..."
      }
    }
  }
}

Elimina las entradas -e/env para cualquier cliente que no utilices.

Desarrollo local

npm install
cp .env.example .env  # then edit
SABNZBD_URL=... SABNZBD_API_KEY=... npm run dev

Seguridad

El contenedor se ejecuta como un usuario no root (mcp).
Las credenciales se pasan a través de variables de entorno, nunca se integran en la imagen.
Un .githooks/pre-commit ejecuta gitleaks (secretos) y una comprobación de patrones PII (rutas de inicio de usuario, correos electrónicos de dominios personales). Actívalo una vez por clonación: git config core.hooksPath .githooks.