prowlarr-mcp

Prowlarr 用の MCP サーバー。

セットアップ

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

.env に PROWLARR_API_KEY を設定します。API キーは Prowlarr の 設定 → 一般 → セキュリティ で確認できます。

構成:

Related MCP server: qBittorrent MCP Server

実行

uv run prowlarr-mcp

Codex/OpenCode スタイルの stdio 設定の例:

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

ツール

search_releases は次を受け付けます:

• query: テキストクエリ。空文字の場合は最近のリリースを要求します。

• search_type: search、tvsearch、movie、music、book のいずれか。

• indexer_ids: オプションの Prowlarr インデクサー ID。

• categories: オプションの Newznab カテゴリ ID。

• limit: 結果の件数。デフォルトは 20 で、設定により上限が適用されます。

• offset: 非負の結果オフセット。

レスポンスは Prowlarr の完全な ReleaseResource より意図的に小さく、将来のダウンロード送信ワークフローのために indexer_id と guid を保持しています。Prowlarr は limit を複数のインデクサーに個別に適用することがあるため、MCP サーバーは結合されたレスポンスでもこれを適用します。truncated は MCP サーバーが受信したレスポンスの一部を破棄したことを意味します。これは has_more ページネーションのインジケーターではなく、Prowlarr が追加の結果を持っているかどうかを証明するものではありません。

ロードマップ

• v0.1: 設定された Prowlarr インデクサーを通じてリリースを検索する。

• 利用可能なインデクサーと検索カテゴリを検出する。

• 選択したリリースを設定済みのダウンロードクライアントに送信する。

• Prowlarr のヘルス、インデクサーのステータス、検索履歴を確認する。

MCP クライアントでのテスト

このリポジトリには、サーバーを起動して 1 つのツールを呼び出すための汎用 stdio クライアントが含まれています:

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

サーバーコマンドを別のディレクトリから実行する必要がある場合は --cwd を使用し、デフォルトの 60 秒のツール呼び出しタイムアウトを上書きするには --timeout を使用します。この秒cript は構造化されたツール出力を JSON として出力し、無効な入力、接続失敗、または MCP ツールエラーが発生した場合に非ゼロで終了します。

開発

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