downloader-mcp

Ein MCP-Server für Download-Clients — SABnzbd (Usenet) und qBittorrent (Torrents) — verpackt als Docker-Container. Begleiter für Media-Management-MCPs wie servarr-mcp.

Jeder Client ist optional: Konfigurieren Sie nur die, die Sie tatsächlich verwenden, und nur diese Tools werden registriert.

Tools

SABnzbd (Usenet)

Tool	Beschreibung
`sabnzbd_queue`	Aktuelle Download-Warteschlange mit Geschwindigkeiten und ETAs
`sabnzbd_history`	Kürzlicher Verlauf (neueste zuerst)
`sabnzbd_categories`	Konfigurierte Kategorien
`sabnzbd_version`	SABnzbd-Versionsinformationen

qBittorrent (Torrents)

Tool	Beschreibung
`qbittorrent_list_torrents`	Torrents auflisten, optionaler Statusfilter
`qbittorrent_get_torrent`	Torrent-Details nach Info-Hash
`qbittorrent_torrent_files`	Dateien innerhalb eines Torrents
`qbittorrent_transfer_info`	Globale Transferstatistiken
`qbittorrent_categories`	Konfigurierte Kategorien
`qbittorrent_version`	qBittorrent-Anwendungsversion

Konfiguration

Jeder Client erfordert seinen vollständigen Konfigurationsblock zur Aktivierung; eine unvollständige Konfiguration deaktiviert den Client stillschweigend.

Client	Erforderliche Umgebungsvariablen	Standard-Port
SABnzbd	`SABNZBD_URL`, `SABNZBD_API_KEY`	8080
qBittorrent	`QBITTORRENT_URL`, `QBITTORRENT_USERNAME`, `QBITTORRENT_PASSWORD`	8080

API-Schlüssel / Anmeldedaten finden Sie in den Einstellungen der jeweiligen App:

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

Hinweis: SABnzbd und qBittorrent verwenden beide standardmäßig Port 8080. Wenn Sie beide auf demselben Host ausführen, ordnen Sie einen davon in seiner eigenen Konfiguration neu zu.

Mindestens ein Client muss konfiguriert sein, sonst beendet sich der Server mit einem Fehler.

Ausführen mit 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

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "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": "..."
      }
    }
  }
}

Lassen Sie die -e/env-Einträge für den Client weg, den Sie nicht verwenden.

Lokale Entwicklung

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

Sicherheit

Der Container läuft als Nicht-Root-Benutzer (mcp).
Anmeldedaten werden über Umgebungsvariablen übergeben — niemals fest in das Image eingebettet.
Ein .githooks/pre-commit führt gitleaks (Geheimnisse) und eine PII-Musterprüfung (Benutzer-Home-Pfade, persönliche Domain-E-Mails) durch. Aktivieren Sie es einmal pro Klon: git config core.hooksPath .githooks.