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)

qBittorrent (Torrents)

Related MCP server: NZBGet MCP Server

Konfiguration

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

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.