prowlarr-mcp

Ein MCP-Server für Prowlarr.

Einrichtung

cd prowlarr-mcp
uv sync
cp .env.example .env

Setze PROWLARR_API_KEY in .env. Der API-Schlüssel ist in Prowlarr unter Einstellungen → Allgemein → Sicherheit verfügbar.

Konfiguration:

Related MCP server: qBittorrent MCP Server

Ausführen

uv run prowlarr-mcp

Beispiel einer stdio-Konfiguration im Codex/OpenCode-Stil:

{
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/prowlarr-mcp",
    "run",
    "prowlarr-mcp"
  ]
}

Tool

search_releases akzeptiert:

• query: Textabfrage; eine leere Zeichenfolge fordert aktuelle Releases an.

• search_type: search, tvsearch, movie, music oder book.

• indexer_ids: optionale Prowlarr-Indexer-IDs.

• categories: optionale Newznab-Kategorie-IDs.

• limit: Anzahl der Ergebnisse, standardmäßig 20 und durch die Konfiguration begrenzt.

• offset: nicht-negativer Ergebnis-Offset.

Die Antwort ist absichtlich kleiner als die vollständige ReleaseResource von Prowlarr, behält aber indexer_id und guid für einen zukünftigen Workflow zur Übermittlung von Downloads. Prowlarr kann limit unabhängig auf mehrere Indexer anwenden, daher erzwingt der MCP-Server es auch für die zusammengefügte Antwort. truncated bedeutet, dass der MCP-Server einen Teil der empfangenen Antwort verworfen hat; es ist kein has_more-Paginationsindikator und kann nicht belegen, ob Prowlarr weitere Ergebnisse hat.

Roadmap

• v0.1: Suche nach Releases über die konfigurierten Prowlarr-Indexer.

• Verfügbare Indexer und Suchkategorien ermitteln.

• Eine ausgewählte Release an einen konfigurierten Download-Client übermitteln.

• Prowlarr-Health, Indexerstatus und Suchverlauf einsehen.

Testen mit dem MCP-Client

Das Repository enthält einen generischen stdio-Client zum Starten des Servers und zum Aufrufen eines Tools:

uv run src/prowlarr_mcp/scripts/mcp_client.py \
  --command "uv run prowlarr-mcp" \
  --method "search_releases" \
  --arguments '{"query": "yani neko"}'

Verwenden Sie --cwd, wenn der Serverbefehl aus einem anderen Verzeichnis ausgeführt werden muss, und --timeout, um das Standard-Timeout von 60 Sekunden für Tool-Aufrufe zu überschreiben. Das Skript gibt die strukturierte Tool-Ausgabe als JSON aus und beendet sich bei ungültiger Eingabe, Verbindungsfehlern oder MCP-Tool-Fehlern mit einem von Null verschiedenen Exit-Code.

Entwicklung

uv run ruff format --check .
uv run ruff check .
uv run pyrefly check
uv run python -m unittest discover -s tests