mcp-arr-lite

Servidor MCP ligero para Radarr y Sonarr con un conjunto pequeño de herramientas granulares y específicas. Proyecto no oficial.

¿Por qué este proyecto?

Los servidores MCP "arr" generales (como Knuckles-Team/arr-mcp) generan automáticamente miles de herramientas a partir de la API de Arr y entregan toda la superficie al LLM. mcp-arr-lite es lo contrario:

• Herramientas granulares: exactamente las operaciones necesarias para el flujo "¿puedes buscar X para mí?" — búsqueda, añadir, buscar lanzamientos, descargar — sin ruido de administración/configuración.

• Lógica de indexador preferido: las herramientas de búsqueda usan por defecto el indexador con la prioridad numérica más baja, determinista en lugar de depender del prompt.

• Amigable con HITL: las herramientas de solo lectura (búsqueda, listar indexadores) se pueden aprobar automáticamente; añadir/buscar/descargar requieren aprobación explícita del usuario.

• Transporte dual: stdio (npx) y HTTP (Docker).

Comparación con Knuckles-Team/arr-mcp

Related MCP server: overseerr-mcp

Herramientas

Requisitos

• Node.js >= 20 (npx) o Docker (contenedor)

• Radarr y/o Sonarr con una clave API

Instalación

Docker Compose (recomendado)

services:
  arr-mcp:
    image: ghcr.io/cuti27/mcp-arr-lite:latest
    restart: unless-stopped
    environment:
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-radarr-api-key
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-sonarr-api-key
      - MCP_TRANSPORT=http
      - MCP_AUTH_TOKEN=your-secure-token-here
      - PORT=3000
      - HOST=0.0.0.0
      - LOG_LEVEL=info

Solo configura las aplicaciones que uses — Radarr y Sonarr son opcionales al inicio; las herramientas para una aplicación no configurada devolverán un error.

stdio (npx)

RADARR_URL=http://radarr:7878 \
RADARR_API_KEY=... \
SONARR_URL=http://sonarr:8989 \
SONARR_API_KEY=... \
MCP_TRANSPORT=stdio \
npx -y @cuti27/mcp-arr-lite

Variables de entorno

Consulta .env.example. Requeridas por aplicación: RADARR_URL + RADARR_API_KEY, SONARR_URL + SONARR_API_KEY. MCP_AUTH_TOKEN es necesario cuando MCP_TRANSPORT=http.

Seguridad

• El transporte HTTP impone autenticación bearer, limitación de tasa (60 solicitudes/min/IP) y un límite de cuerpo de 1 MB.

• Las claves API se redactan de los registros.

• Solo ejecuta el transporte HTTP con MCP_AUTH_TOKEN configurado y detrás de un proxy inverso con terminación TLS.

Licencia

MIT