lutris-source-mcp

lutris-mcp 用のソースパイプラインMCPです。 検索 → ダウンロード → インストール のループを完結させます。Prowlarrで検索し、qBittorrentに引き渡し、完了までポーリングし、結果のツリーを分類し、lutris-mcpの install_from_yaml または install_from_directory が直接利用できるパスを返します。

ツール

マルチトラッカーランキング

Prowlarrはパブリック（1337x、TPBなど）およびプライベート（Gazelle: RED, OPS, GGn）トラッカーを1つの検索に集約します。この複合ツールは以下のキーでそれらをランク付けします：

(indexer_priority,                          # 1 = highest, 50 = lowest
 freeleech_first if freeleech_only else 0,
 -seeders,
 size_bytes)                                # smaller wins as tiebreak

indexer_priority はProwlarrインデクサーの priority フィールドから取得されます。ProwlarrのUIでトラッカーごとに設定してください（例: プライベート = 1, パブリック = 25）。MCPは独自の信頼度ランキングを作成するのではなく、これを尊重します。

Gazelleの衛生管理

freeleech_only=True を渡す（またはTOMLで policy.freeleech_only = true を設定する）と、ランキング前にGazelleインデクサーから非フリーリーチの結果を除外します。パブリックな結果はそのまま通過します（パブリックではフリーリーチは無意味なため）。認証自体はProwlarrのUI内で行われ、MCPがGazelleの認証情報を見ることはありません。

ストール検知

ポーリングのたびに標準出力にハートビートが表示されます：

[prepare_install_source] deadbeef dl=12345/100000 (12.3%) peers=8 rate=215.4KiB/s elapsed=14s

downloaded が stall_timeout_seconds（デフォルト5分）の間増加しない場合、ツールは {ok: false, reason: "stalled"} を返し、エージェントが別の候補を選択できるようにします。

設定

~/.config/lutris-source-mcp/config.toml:

[prowlarr]
base_url = "http://localhost:9696"
api_key  = "..."

[qbittorrent]
base_url     = "http://localhost:8080"
username     = "admin"
password     = "..."
download_dir = "/mnt/games/Downloads"

[policy]
blocklist      = ["fitgirl"]
allow_indexers = []
max_size_gb    = 50
freeleech_only = false
min_seeders    = 1

すべてのキーには LUTRIS_SOURCE_MCP_<SECTION>_<KEY> という環境変数によるオーバーライドが可能です（例: LUTRIS_SOURCE_MCP_PROWLARR_API_KEY, LUTRIS_SOURCE_MCP_POLICY_FREELEECH_ONLY）。

コンパニオン

Prowlarr/qBittorrentの読み取り専用検査には、jmagar/prowlarr-mcp および pickpppcc/qbittorrent-mcp を併用してください。重複のない、3つの小さく特化したサーバーです。

ライセンス

MIT。