arr-mcp

Ein kleiner Model Context Protocol-Server, der den *arr-Medienstapel (Sonarr, Radarr, Prowlarr, Jellyseerr, Bazarr) hinter saubere, typisierte Tools stellt. Ein MCP-Client wie Claude ruft diese Tools direkt über die REST-API jeder App auf – kein Browser, kein Screen-Scraping, kein VPN ins LAN.

Der Server verwahrt die API-Schlüssel selbst; der Client sieht sie nie. Er läuft auf dem .104-Docker-Host und wird aus der Cloud über einen authentifizierten Cloudflare-Tunnel erreicht, sodass er funktioniert, egal ob du zu Hause bist oder Claude vom Handy aus steuerst.

Warum es das gibt

Alles, was Claude zuvor im Medienstapel erledigte, lief über eine Browser-Erweiterung auf dem Mac – was zu Verbindungsidentitäts-Chaos („Welcher Browser?“), Session-/2FA-Reibung und dem VPN-+Fernsteuerungs-Tanz führte. Dieser Server entfernt Browser und Mac vollständig aus dem Kreislauf und ersetzt UI-Scraping durch schnelle, strukturierte API-Aufrufe.

Related MCP server: mcp-arr-suite

Tools

* = Schreibaktion (löst eine Suche aus oder leert die Blocklist einer Serie). Alles andere ist schreibgeschützt. Es gibt bewusst keine Lösch-/Entfernungs- oder Konfigurationsänderungs-Tools – das hält den Schadensradius klein. Später bei Bedarf mehr hinzufügen.

Setup

cp config.example.env .env
# edit .env: real API keys (Settings > General > Security > API Key in each app)
# and a strong MCP_AUTH_TOKEN:  python3 -c "import secrets; print(secrets.token_urlsafe(48))"

docker compose up -d --build

Schneller lokaler Check (sollte eine 400/406 über eine fehlende MCP-Sitzung zurückgeben – das bedeutet, es ist aktiv und dein Token wurde akzeptiert; eine 401 bedeutet, das Token ist falsch):

curl -s -o /dev/null -w "%{http_code}\n" \
  -H "Authorization: Bearer <your MCP_AUTH_TOKEN>" \
  http://localhost:8787/mcp

Ohne Docker ausführen (für die Entwicklung)

pip install -r requirements.txt
set -a; source .env; set +a
python server.py

Claude verfügbar machen

Der MCP-Endpunkt ist https://<your-hostname>/mcp.

1. Tunnel einrichten. Entweder den cloudflared-Dienst in docker-compose.yml auskommentieren und ihm einen eigenen Tunnel geben, oder einen Hostnamen zu deinem bestehenden Jellyfin-Tunnel hinzufügen, der auf http://arr-mcp:8787 (oder vom Host aus http://localhost:8787) zeigt. Setze Cloudflare Access vor den Hostnamen oder verlasse dich auf das Bearer-Token – idealerweise beides.

2. Als benutzerdefinierten Connector in Claude hinzufügen. Einstellungen → Anpassen → Connectors → Benutzerdefinierten Connector hinzufügen → URL https://<your-hostname>/mcp. Gib das Bearer-Token als Authorization: Bearer <token>-Header an. Claude listet dann die obigen Tools auf.

Sicherheitshinweise

• Das Bearer-Token (MCP_AUTH_TOKEN) ist erforderlich, bevor der Endpunkt überhaupt aus dem Internet erreichbar ist. Wenn es leer ist, gibt der Server eine Warnung aus und bedient ohne Authentifizierung – nur akzeptabel, wenn an localhost gebunden.

• Der Container bindet standardmäßig an 127.0.0.1:8787, sodass nichts außer durch den von dir gewählten Tunnel exponiert ist.

• API-Schlüssel liegen nur in .env (git-ignoriert, docker-ignoriert). Rotiere sie in jeder App, falls sie jemals leaken.

• Der Umfang ist bewusst leselastig. Bevor du destruktive Tools hinzufügst (Serie löschen, aus Warteschlange entfernen, Einstellungen bearbeiten), entscheide, ob der Komfort das Risiko auf einem aus dem Internet erreichbaren Endpunkt wert ist.

Dateien

• server.py — der MCP-Server und alle Tools (Streamable-HTTP-Transport + Bearer-Auth)

• arr_client.py — dünner asynchroner REST-Client, der von jedem Dienst gemeinsam genutzt wird

• config.py — baut einen Client pro Dienst aus Umgebungsvariablen (fehlend = deaktiviert)

• Dockerfile / docker-compose.yml — Container + optionaler Tunnel

• config.example.env — Kopiere nach .env