arr_mcp

ARR-MCP es un servidor MCP (Model Context Protocol) que conecta asistentes de IA como Claude, Cursor y VS Code con el stack multimedia *Arr, incluidos Sonarr, Radarr, Prowlarr, Bazarr, qBittorrent y NZBGet. Admite múltiples instancias de cada servicio, lo que permite a los usuarios ejecutar configuraciones separadas (p. ej., instancias de Sonarr para 4K y 1080p) y direccionarlas por nombre. El servidor implementa MCP real usando JSON-RPC 2.0 sobre stdio y Streamable HTTP, construido sobre el SDK oficial de Go. Proporciona 246 herramientas en todos los servicios compatibles, lo que permite a los usuarios realizar tareas que de otro modo harían a través de la interfaz web de cada servicio. Estas herramientas cubren gestión de bibliotecas, operaciones de búsqueda e importación, configuración de perfiles de calidad, gestión de proveedores y operaciones del sistema. Las características clave incluyen: - Soporte para múltiples instancias con instancias nombradas y selección predeterminada - Controles de permisos con tres modos: solo lectura, confirmación (predeterminado) y acceso completo - Ajustes de alcance de confirmación para operaciones de escritura o destructivas - Comportamiento de reserva para clientes sin soporte de elicitación - Único binario estático con contenedor distroless y soporte de imágenes multi-arquitectura - Manifiestos de despliegue de Kubernetes incluidos La configuración se puede realizar mediante variables de entorno para instancias únicas o un archivo config.yaml para múltiples instancias. El archivo de configuración admite referenciar secretos mediante variables de entorno, lo que hace que sea seguro confirmarlo o montarlo desde un ConfigMap. El servidor valida la configuración al inicio, detectando errores antes de que aparezcan durante la operación. Las herramientas están organizadas por servicio y tipo de acceso (lectura, escritura, destructivo). Sonarr y Radarr mantienen paridad con 62 nombres de herramientas comunes. Bazarr proporciona herramientas de gestión de subtítulos, Prowlarr gestiona la administración de indexadores y la captura de releases, mientras que qBittorrent y NZBGet ofrecen funcionalidad de cliente de descargas de torrents y Usenet, respectivamente. El servidor incluye comprobaciones de estado, admite transportes stdio y HTTP, y proporciona configuración lista para copiar y pegar en varios clientes MCP. Los payloads de respuesta se proyectan para incluir solo los campos relevantes en lugar de los datos completos de origen, manteniendo las respuestas manejables mientras proporcionan la información necesaria para la toma de decisiones.