lutris-source-mcp

用于 lutris-mcp 的源流水线 MCP。 闭环 查找 -> 下载 -> 安装 流程：搜索 Prowlarr，移交给 qBittorrent，轮询直至完成，对结果树进行分类，并返回一个 lutris-mcp 的 install_from_yaml 或 install_from_directory 可以直接使用的路径。

工具

多追踪器排名

Prowlarr 在一次搜索中聚合了公共（1337x, TPB 等）和私有（Gazelle: RED, OPS, GGn）追踪器。该复合工具使用以下键对它们进行排名：

(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 索引器中剔除非免费下载（freeleech）结果。公共结果保持不变（freeleech 在那里没有意义）。身份验证本身保留在 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。 三个小型专注的服务器，互不重叠。

许可证

MIT。