Skip to main content
Glama
deenesjakoruzh
CT4nk3r

arrstack-mcp

by CT4nk3r
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

🎬 arrstack-mcp

Un servidor MCP que otorga a los asistentes de IA control sobre tu stack de medios de homelab: Sonarr, Radarr, Prowlarr, qBittorrent y Jellyfin.

Funciona con Claude Desktop, Cursor, VS Code Copilot, OpenClaw y cualquier otro cliente compatible con MCP.

Demo

OpenClaw usando arrstack-mcp para buscar y descargar medios

Related MCP server: nas-mcp-server

Características

Servicio

Herramientas

Sonarr

Listar series, buscar y añadir programas, próximos episodios, cola de descarga

Radarr

Listar películas, buscar y añadir películas, cola de descarga

Prowlarr

Listar/probar indexadores, buscar lanzamientos, comprobación de estado

qBittorrent

Listar/pausar/reanudar/eliminar torrents, añadir enlaces magnet, estadísticas de transferencia

Jellyfin

Listar bibliotecas, adiciones recientes, información del sistema

Configura solo los servicios que utilices; los servicios no configurados se omiten correctamente.

Inicio rápido

Opción 1: Claude Desktop / Cursor / VS Code (stdio)

  1. Instala las dependencias:

    pip install "mcp[cli]>=1.9.0" httpx

  2. Añade a la configuración de tu cliente MCP (ej. claude_desktop_config.json):

    {
  "mcpServers": {
    "arrstack": {
      "command": "python",
      "args": ["/path/to/arrstack-mcp/server.py"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-api-key",
        "QBT_URL": "http://localhost:8080",
        "QBT_USER": "admin",
        "QBT_PASS": "your-password",
        "JELLYFIN_URL": "http://localhost:8096"
      }
    }
  }
}

  3. Reinicia tu cliente MCP. ¡Listo!

Opción 2: Docker (transporte HTTP)

Para configuraciones remotas o cuando se ejecuta junto a tu stack *arr:

git clone https://github.com/ct4nk3r/arrstack-mcp.git
cd arrstack-mcp
cp .env.example .env
# Edit .env with your service URLs and API keys
docker compose up -d

El servidor se ejecuta en el puerto 8000 con transporte HTTP Streamable.

Conectar a OpenClaw

openclaw mcp set arrstack '{"url":"http://arrstack-mcp:8000/mcp","transport":"streamable-http"}'

Conectar a otros clientes MCP HTTP

Apunta tu cliente a http://<host>:8000/mcp usando transporte HTTP Streamable.

Opción 3: Docker en la misma red que tu stack *arr

Si tus servicios de medios se ejecutan en Docker, añade arrstack-mcp a la misma red:

services:
  arrstack-mcp:
    build: .
    container_name: arrstack-mcp
    ports:
      - "8000:8000"
    environment:
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-key
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-key
      - QBT_URL=http://qbittorrent:8080
      - QBT_USER=admin
      - QBT_PASS=your-password
      - JELLYFIN_URL=http://jellyfin:8096
    networks:
      - your-media-network

Configuración

Toda la configuración se realiza a través de variables de entorno:

Variable

Requerido

Descripción

SONARR_URL

No

URL base de Sonarr (ej. http://localhost:8989)

SONARR_API_KEY

Si usa Sonarr

Clave API de Sonarr (Ajustes → General)

RADARR_URL

No

URL base de Radarr (ej. http://localhost:7878)

RADARR_API_KEY

Si usa Radarr

Clave API de Radarr (Ajustes → General)

QBT_URL

No

URL de la interfaz web de qBittorrent (ej. http://localhost:8080)

QBT_USER

Si usa qBt

Nombre de usuario de qBittorrent (predeterminado: admin)

QBT_PASS

Si usa qBt

Contraseña de qBittorrent

JELLYFIN_URL

No

URL base de Jellyfin (ej. http://localhost:8096)

JELLYFIN_API_KEY

No

Clave API de Jellyfin (opcional, para endpoints autenticados)

PROWLARR_URL

No

URL base de Prowlarr (ej. http://localhost:9696)

PROWLARR_API_KEY

Si usa Prowlarr

Clave API de Prowlarr (Ajustes → General)

Herramientas disponibles

Sonarr (Programas de TV)

Herramienta

Descripción

sonarr_list_series

Listar todas las series con conteo de episodios y uso de disco

sonarr_get_series

Obtener información detallada sobre una serie específica

sonarr_search

Buscar nuevos programas para añadir

sonarr_add_series

Añadir un programa por ID de TVDB

sonarr_upcoming

Mostrar próximos episodios

sonarr_queue

Mostrar cola de descarga actual

Radarr (Películas)

Herramienta

Descripción

radarr_list_movies

Listar todas las películas con estado de descarga

radarr_get_movie

Obtener información detallada sobre una película específica

radarr_search

Buscar nuevas películas para añadir

radarr_add_movie

Añadir una película por ID de TMDB

radarr_queue

Mostrar cola de descarga actual

Prowlarr (Indexadores)

Herramienta

Descripción

prowlarr_list_indexers

Listar todos los indexadores con estado

prowlarr_test_indexer

Probar una conexión de indexador específica

prowlarr_test_all_indexers

Probar todos los indexadores habilitados

prowlarr_search

Buscar lanzamientos en los indexadores

prowlarr_health

Comprobar advertencias de salud del sistema

qBittorrent (Descargas)

Herramienta

Descripción

qbt_list_torrents

Listar torrents con progreso y velocidad

qbt_torrent_details

Obtener información detallada del torrent

qbt_add_magnet

Añadir un enlace magnet

qbt_pause

Pausar un torrent

qbt_resume

Reanudar un torrent

qbt_delete

Eliminar un torrent (opcionalmente con archivos)

qbt_transfer_info

Estadísticas globales de transferencia

Jellyfin (Servidor de medios)

Herramienta

Descripción

jellyfin_libraries

Listar bibliotecas de medios

jellyfin_recent

Elementos añadidos recientemente

jellyfin_system_info

Versión del servidor e información del sistema

Opciones de transporte

# stdio (default) — for Claude Desktop, Cursor, VS Code
python server.py

# Streamable HTTP — for Docker / remote
python server.py --transport streamable-http --port 8000

# SSE — legacy HTTP transport
python server.py --transport sse --port 8000

Cómo encontrar tus claves API

  • Sonarr: Ajustes → General → Clave API

  • Radarr: Ajustes → General → Clave API

  • Prowlarr: Ajustes → General → Clave API

  • qBittorrent: Ajustes → Interfaz Web → Autenticación

  • Jellyfin: Panel de control → Claves API → Añadir

Licencia

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessWithin a week

Resources

Related MCP Connectors

Related MCP Servers

  • nas-mcp-server

    matthieurosset
    A
    license
    A
    quality
    D
    maintenance
    MCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.
    12
    MIT

  • mcparr

    PhillyUrbs
    A
    license
    Not graded
    quality
    D
    maintenance
    A self-hosted MCP gateway that lets AI assistants drive your media services like Radarr and Sonarr through a single authenticated endpoint.
    AGPL 3.0

  • mcp-homelab

    asvarnon
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that gives AI assistants real-time access to your homelab infrastructure. It enables querying node status, managing Docker containers, controlling Proxmox VMs, and inspecting OPNsense firewall state through natural conversation.
    2
    MIT