servarr-mcp

Un servidor MCP para la pila Servarr — Sonarr, Radarr, Lidarr, Readarr y Prowlarr — empaquetado como un contenedor Docker. Permite que un cliente MCP (Claude Desktop, etc.) explore y busque en las aplicaciones *arr que estés ejecutando.

Las aplicaciones son opcionales: configura solo las que realmente ejecutas, y solo esas herramientas se registrarán.

Herramientas

Sonarr (TV)

Herramienta	Descripción
`sonarr_list_series`	Listar todas las series de TV seguidas por Sonarr
`sonarr_get_series`	Detalles de la serie por ID
`sonarr_lookup_series`	Buscar en TVDB una nueva serie para añadir
`sonarr_list_episodes`	Listar episodios de una serie
`sonarr_calendar`	Próximos episodios
`sonarr_queue`	Cola de descarga actual
`sonarr_history`	Historial reciente (más nuevo primero)

Radarr (películas)

Herramienta	Descripción
`radarr_list_movies`	Todas las películas seguidas por Radarr
`radarr_get_movie`	Detalles de la película por ID
`radarr_lookup_movie`	Buscar en TMDB una nueva película para añadir
`radarr_calendar`	Próximos estrenos de películas
`radarr_queue`	Cola de descarga actual
`radarr_history`	Historial reciente (más nuevo primero)

Lidarr (música)

Herramienta	Descripción
`lidarr_list_artists`	Todos los artistas seguidos por Lidarr
`lidarr_get_artist`	Detalles del artista por ID
`lidarr_lookup_artist`	Buscar un nuevo artista para añadir
`lidarr_list_albums`	Listar álbumes (opcionalmente por artista)
`lidarr_queue`	Cola de descarga actual
`lidarr_history`	Historial reciente

Readarr (libros)

Herramienta	Descripción
`readarr_list_authors`	Todos los autores seguidos por Readarr
`readarr_get_author`	Detalles del autor por ID
`readarr_lookup_author`	Buscar un nuevo autor para añadir
`readarr_list_books`	Listar libros (opcionalmente por autor)
`readarr_queue`	Cola de descarga actual
`readarr_history`	Historial reciente

Prowlarr (gestor de indexadores)

Herramienta	Descripción
`prowlarr_list_indexers`	Todos los indexadores configurados
`prowlarr_indexer_stats`	Estadísticas de consulta/captura por indexador
`prowlarr_search`	Buscar en los indexadores habilitados
`prowlarr_history`	Historial reciente (consultas, capturas)

Configuración

Cada aplicación utiliza dos variables de entorno. Configura ambas para una aplicación para habilitar sus herramientas; déjalas sin configurar para omitir la aplicación por completo.

Aplicación	Variable URL	Variable API key	Puerto predeterminado
Sonarr	`SONARR_URL`	`SONARR_API_KEY`	8989
Radarr	`RADARR_URL`	`RADARR_API_KEY`	7878
Lidarr	`LIDARR_URL`	`LIDARR_API_KEY`	8686
Readarr	`READARR_URL`	`READARR_API_KEY`	8787
Prowlarr	`PROWLARR_URL`	`PROWLARR_API_KEY`	9696

Las claves API se encuentran en Settings → General → API Key de cada aplicación.

Al menos una aplicación debe estar configurada o el servidor se cerrará con un error.

Ejecutar con Docker

docker build -t servarr-mcp .
docker run -i --rm \
  -e SONARR_URL=http://192.168.1.50:8989 -e SONARR_API_KEY=... \
  -e RADARR_URL=http://192.168.1.50:7878 -e RADARR_API_KEY=... \
  -e PROWLARR_URL=http://192.168.1.50:9696 -e PROWLARR_API_KEY=... \
  servarr-mcp

Usar con Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "servarr": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SONARR_URL", "-e", "SONARR_API_KEY",
        "-e", "RADARR_URL", "-e", "RADARR_API_KEY",
        "-e", "PROWLARR_URL", "-e", "PROWLARR_API_KEY",
        "servarr-mcp"
      ],
      "env": {
        "SONARR_URL": "http://192.168.1.50:8989",
        "SONARR_API_KEY": "...",
        "RADARR_URL": "http://192.168.1.50:7878",
        "RADARR_API_KEY": "...",
        "PROWLARR_URL": "http://192.168.1.50:9696",
        "PROWLARR_API_KEY": "..."
      }
    }
  }
}

Repite los patrones de bloque -e y env para las aplicaciones que ejecutes.

Desarrollo local

npm install
cp .env.example .env  # then edit
SONARR_URL=... SONARR_API_KEY=... npm run dev

Seguridad

El contenedor se ejecuta como un usuario no root (servarr).
Las claves API se pasan a través de variables de entorno; nunca las incorpores en la imagen.
Un .githooks/pre-commit ejecuta gitleaks en cada commit. Actívalo una vez por clonación: git config core.hooksPath .githooks.

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

servarr-mcp

servarr-mcp

Herramientas

Sonarr (TV)

Radarr (películas)

Lidarr (música)

Readarr (libros)

Prowlarr (gestor de indexadores)

Configuración

Ejecutar con Docker

Usar con Claude Desktop

Desarrollo local

Seguridad

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API