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)

qBittorrent (torrents)

Related MCP server: NZBGet MCP Server

Configuración

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

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.