lutris-source-mcp

MCP de canalización de origen para lutris-mcp. Cierra el ciclo buscar -> descargar -> instalar: busca en Prowlarr, transfiere a qBittorrent, consulta hasta finalizar, clasifica el árbol resultante y devuelve una ruta que install_from_yaml o install_from_directory de lutris-mcp consume directamente.

Herramientas

Clasificación de múltiples rastreadores

Prowlarr agrega rastreadores públicos (1337x, TPB, etc.) y privados (Gazelle: RED, OPS, GGn) en una sola búsqueda. El compuesto los clasifica con esta clave:

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

indexer_priority proviene del campo priority del indexador de Prowlarr: configúralo en la interfaz de usuario de Prowlarr por rastreador (ej. privado = 1, público = 25). El MCP lo respeta en lugar de inventar una clasificación de confianza separada.

Higiene de Gazelle

Pasa freeleech_only=True (o establece policy.freeleech_only = true en TOML) para descartar resultados que no sean freeleech de los indexadores de Gazelle antes de clasificar. Los resultados públicos pasan sin cambios (el freeleech no tiene sentido allí). La autenticación permanece en la interfaz de usuario de Prowlarr; el MCP nunca ve las credenciales de Gazelle.

Detección de bloqueo

Cada consulta imprime un latido en stdout:

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

Si downloaded no aumenta durante stall_timeout_seconds (por defecto 5 min), la herramienta devuelve {ok: false, reason: "stalled"} para que el agente pueda elegir otro candidato.

Configuración

~/.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

Cada clave tiene una anulación de variable de entorno LUTRIS_SOURCE_MCP_<SECCIÓN>_<CLAVE> (ej. LUTRIS_SOURCE_MCP_PROWLARR_API_KEY, LUTRIS_SOURCE_MCP_POLICY_FREELEECH_ONLY).

Complementos

Para la inspección de solo lectura de Prowlarr/qBittorrent, instala jmagar/prowlarr-mcp y pickpppcc/qbittorrent-mcp conjuntamente. Tres servidores pequeños y enfocados, sin solapamiento.

Licencia

MIT.