mcp-arr-lite

Leichter MCP-Server für Radarr und Sonarr mit einer kleinen Sammlung granularer, zweckgerichteter Werkzeuge. Inoffizielles Projekt.

Warum dieses Projekt?

Allgemeine „arr“-MCP-Server (wie Knuckles-Team/arr-mcp) generieren automatisch Tausende von Werkzeugen aus der Arr-API und übergeben die gesamte Oberfläche an das LLM. mcp-arr-lite ist das Gegenteil:

• Granulare Werkzeuge: genau die Operationen, die für den „Kannst du X für mich holen?“-Ablauf benötigt werden – lookup, add, search releases, grab – kein Admin-/Konfigurationsrauschen.

• Bevorzugte-Indexer-Logik: Suchwerkzeuge verwenden standardmäßig den Indexer mit der niedrigsten numerischen Priorität, deterministisch statt promptabhängig.

• HITL-freundlich: schreibgeschützte Werkzeuge (lookup, list indexers) können automatisch genehmigt werden; add/search/grab erfordern explizite Benutzerzustimmung.

• Dualer Transport: stdio (npx) und HTTP (Docker).

Vergleich mit Knuckles-Team/arr-mcp

Related MCP server: overseerr-mcp

Werkzeuge

Voraussetzungen

• Node.js >= 20 (npx) oder Docker (Container)

• Radarr und/oder Sonarr mit einem API-Schlüssel

Installation

Docker Compose (empfohlen)

services:
  arr-mcp:
    image: ghcr.io/cuti27/mcp-arr-lite:latest
    restart: unless-stopped
    environment:
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-radarr-api-key
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-sonarr-api-key
      - MCP_TRANSPORT=http
      - MCP_AUTH_TOKEN=your-secure-token-here
      - PORT=3000
      - HOST=0.0.0.0
      - LOG_LEVEL=info

Konfiguriere nur die Apps, die du verwendest – Radarr und Sonarr sind beide beim Start optional; Werkzeuge für eine nicht konfigurierte App geben einen Fehler zurück.

stdio (npx)

RADARR_URL=http://radarr:7878 \
RADARR_API_KEY=... \
SONARR_URL=http://sonarr:8989 \
SONARR_API_KEY=... \
MCP_TRANSPORT=stdio \
npx -y @cuti27/mcp-arr-lite

Umgebungsvariablen

Siehe .env.example. Erforderlich pro App: RADARR_URL + RADARR_API_KEY, SONARR_URL + SONARR_API_KEY. MCP_AUTH_TOKEN ist erforderlich, wenn MCP_TRANSPORT=http.

Sicherheit

• HTTP-Transport erzwingt Bearer-Authentifizierung, Ratenbegrenzung (60 Anfragen/min/IP) und ein 1-MB-Body-Limit.

• API-Schlüssel werden aus Protokollen geschwärzt.

• Führe den HTTP-Transport nur mit gesetztem MCP_AUTH_TOKEN und hinter einem TLS-terminierenden Reverse-Proxy aus.

Lizenz

MIT