Skip to main content
Glama
CT4nk3r

arrstack-mcp

by CT4nk3r

🎬 arrstack-mcp

Ein MCP-Server, der KI-Assistenten die Kontrolle über deinen Sonarr-, Radarr-, Prowlarr-, qBittorrent- und Jellyfin-Homelab-Medienstapel gibt.

Funktioniert mit Claude Desktop, Cursor, VS Code Copilot, OpenClaw und jedem anderen MCP-kompatiblen Client.

Demo

OpenClaw verwendet arrstack-mcp zum Suchen und Herunterladen von Medien

Related MCP server: nas-mcp-server

Funktionen

Dienst

Tools

Sonarr

Serien auflisten, Shows suchen & hinzufügen, kommende Episoden, Download-Warteschlange

Radarr

Filme auflisten, Filme suchen & hinzufügen, Download-Warteschlange

Prowlarr

Indexer auflisten/testen, Releases suchen, Gesundheitsprüfung

qBittorrent

Torrents auflisten/pausieren/fortsetzen/löschen, Magnet-Links hinzufügen, Transfer-Statistiken

Jellyfin

Bibliotheken auflisten, kürzlich hinzugefügt, Systeminformationen

Konfiguriere nur die Dienste, die du verwendest — nicht konfigurierte Dienste werden elegant übersprungen.

Schnellstart

Option 1: Claude Desktop / Cursor / VS Code (stdio)

  1. Abhängigkeiten installieren:

    pip install "mcp[cli]>=1.9.0" httpx
  2. Zur MCP-Client-Konfiguration hinzufügen (z. B. claude_desktop_config.json):

    {
      "mcpServers": {
        "arrstack": {
          "command": "python",
          "args": ["/path/to/arrstack-mcp/server.py"],
          "env": {
            "SONARR_URL": "http://localhost:8989",
            "SONARR_API_KEY": "your-api-key",
            "RADARR_URL": "http://localhost:7878",
            "RADARR_API_KEY": "your-api-key",
            "QBT_URL": "http://localhost:8080",
            "QBT_USER": "admin",
            "QBT_PASS": "your-password",
            "JELLYFIN_URL": "http://localhost:8096"
          }
        }
      }
    }
  3. Starte deinen MCP-Client neu. Fertig!

Option 2: Docker (HTTP-Transport)

Für Remote-Setups oder wenn du es neben deinem *arr-Stapel ausführst:

git clone https://github.com/ct4nk3r/arrstack-mcp.git
cd arrstack-mcp
cp .env.example .env
# Edit .env with your service URLs and API keys
docker compose up -d

Der Server läuft auf Port 8000 mit Streamable HTTP-Transport.

Verbindung zu OpenClaw

openclaw mcp set arrstack '{"url":"http://arrstack-mcp:8000/mcp","transport":"streamable-http"}'

Verbindung zu anderen HTTP-MCP-Clients

Verweise deinen Client auf http://<host>:8000/mcp unter Verwendung des Streamable HTTP-Transports.

Option 3: Docker im selben Netzwerk wie dein *arr-Stapel

Wenn deine Mediendienste in Docker laufen, füge arrstack-mcp zum selben Netzwerk hinzu:

services:
  arrstack-mcp:
    build: .
    container_name: arrstack-mcp
    ports:
      - "8000:8000"
    environment:
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-key
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-key
      - QBT_URL=http://qbittorrent:8080
      - QBT_USER=admin
      - QBT_PASS=your-password
      - JELLYFIN_URL=http://jellyfin:8096
    networks:
      - your-media-network

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen:

Variable

Erforderlich

Beschreibung

SONARR_URL

Nein

Sonarr Basis-URL (z. B. http://localhost:8989)

SONARR_API_KEY

Wenn Sonarr

Sonarr API-Schlüssel (Einstellungen → Allgemein)

RADARR_URL

Nein

Radarr Basis-URL (z. B. http://localhost:7878)

RADARR_API_KEY

Wenn Radarr

Radarr API-Schlüssel (Einstellungen → Allgemein)

QBT_URL

Nein

qBittorrent Web-UI-URL (z. B. http://localhost:8080)

QBT_USER

Wenn qBt

qBittorrent Benutzername (Standard: admin)

QBT_PASS

Wenn qBt

qBittorrent Passwort

JELLYFIN_URL

Nein

Jellyfin Basis-URL (z. B. http://localhost:8096)

JELLYFIN_API_KEY

Nein

Jellyfin API-Schlüssel (optional, für authentifizierte Endpunkte)

PROWLARR_URL

Nein

Prowlarr Basis-URL (z. B. http://localhost:9696)

PROWLARR_API_KEY

Wenn Prowlarr

Prowlarr API-Schlüssel (Einstellungen → Allgemein)

Verfügbare Tools

Sonarr (TV-Serien)

Tool

Beschreibung

sonarr_list_series

Alle Serien mit Episodenanzahl und Festplattennutzung auflisten

sonarr_get_series

Detaillierte Informationen zu einer bestimmten Serie abrufen

sonarr_search

Nach neuen Shows zum Hinzufügen suchen

sonarr_add_series

Eine Show per TVDB-ID hinzufügen

sonarr_upcoming

Kommende Episoden anzeigen

sonarr_queue

Aktuelle Download-Warteschlange anzeigen

Radarr (Filme)

Tool

Beschreibung

radarr_list_movies

Alle Filme mit Download-Status auflisten

radarr_get_movie

Detaillierte Informationen zu einem bestimmten Film abrufen

radarr_search

Nach neuen Filmen zum Hinzufügen suchen

radarr_add_movie

Einen Film per TMDB-ID hinzufügen

radarr_queue

Aktuelle Download-Warteschlange anzeigen

Prowlarr (Indexer)

Tool

Beschreibung

prowlarr_list_indexers

Alle Indexer mit Status auflisten

prowlarr_test_indexer

Verbindung eines bestimmten Indexers testen

prowlarr_test_all_indexers

Alle aktivierten Indexer testen

prowlarr_search

Über Indexer hinweg nach Releases suchen

prowlarr_health

System-Gesundheitswarnungen prüfen

qBittorrent (Downloads)

Tool

Beschreibung

qbt_list_torrents

Torrents mit Fortschritt und Geschwindigkeit auflisten

qbt_torrent_details

Detaillierte Torrent-Informationen abrufen

qbt_add_magnet

Einen Magnet-Link hinzufügen

qbt_pause

Einen Torrent pausieren

qbt_resume

Einen Torrent fortsetzen

qbt_delete

Einen Torrent löschen (optional mit Dateien)

qbt_transfer_info

Globale Transfer-Statistiken

Jellyfin (Medienserver)

Tool

Beschreibung

jellyfin_libraries

Medienbibliotheken auflisten

jellyfin_recent

Kürzlich hinzugefügte Elemente

jellyfin_system_info

Serverversion und Systeminformationen

Transportoptionen

# stdio (default) — for Claude Desktop, Cursor, VS Code
python server.py

# Streamable HTTP — for Docker / remote
python server.py --transport streamable-http --port 8000

# SSE — legacy HTTP transport
python server.py --transport sse --port 8000

API-Schlüssel finden

  • Sonarr: Einstellungen → Allgemein → API-Schlüssel

  • Radarr: Einstellungen → Allgemein → API-Schlüssel

  • Prowlarr: Einstellungen → Allgemein → API-Schlüssel

  • qBittorrent: Einstellungen → Web-UI → Authentifizierung

  • Jellyfin: Dashboard → API-Schlüssel → Hinzufügen

Lizenz

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    MCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.
    12
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A self-hosted MCP gateway that lets AI assistants drive your media services like Radarr and Sonarr through a single authenticated endpoint.
    AGPL 3.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that gives AI assistants real-time access to your homelab infrastructure. It enables querying node status, managing Docker containers, controlling Proxmox VMs, and inspecting OPNsense firewall state through natural conversation.
    2
    MIT