remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to your movie collection data, allowing querying, filtering, and retrieving detailed information about movies in your Radarr library by year, watched status, actors, and other criteria.
Provides access to your TV series and episode data, enabling querying, filtering, and retrieving detailed information about TV shows and episodes in your Sonarr library by various criteria including watched status and cast.

Servidor MCP de Radarr y Sonarr

Un servidor de Protocolo de Contexto de Modelo (MCP) basado en Python que proporciona a los asistentes de IA como Claude acceso a sus datos de Radarr (películas) y Sonarr (series de televisión).

Descripción general

Este servidor MCP permite a los asistentes de IA consultar tu colección de películas y series mediante las API de Radarr y Sonarr. Desarrollado con FastMCP, implementa el protocolo estandarizado para contexto de IA que Claude Desktop y otros clientes compatibles con MCP pueden usar.

Características

Implementación nativa de MCP : desarrollada con FastMCP para una integración perfecta con IA
Integración con Radarr : accede a tu colección de películas
Integración con Sonarr : accede a los datos de tus programas de TV y episodios
Filtrado enriquecido : filtre por año, estado de visualización, actores y más
Compatible con Claude Desktop : funciona a la perfección con el cliente MCP de Claude
Configuración fácil : Asistente de configuración interactivo
Probado exhaustivamente : conjunto completo de pruebas para garantizar la confiabilidad

Instalación

De la fuente

Clonar este repositorio:
git clone https://github.com/yourusername/radarr-sonarr-mcp.git cd radarr-sonarr-mcp-python
Instalar el paquete:
pip install -e .

Usando pip (próximamente)

pip install radarr-sonarr-mcp

Inicio rápido

Configurar el servidor:
radarr-sonarr-mcp configure
Siga las instrucciones para ingresar sus claves API de Radarr/Sonarr y otras configuraciones.
Iniciar el servidor:
radarr-sonarr-mcp start
Conectar Claude Desktop:
- En Claude Desktop, vaya a Configuración > Servidores MCP
- Agregue un nuevo servidor con URL: http://localhost:3000 (o su puerto configurado)

Configuración

El asistente de configuración lo guiará a través de la configuración:

Dirección IP del NAS/Servidor
Clave API y puerto de Radarr
Clave API y puerto de Sonarr
Puerto del servidor MCP

También puedes editar manualmente el archivo config.json :

{
  "nasConfig": {
    "ip": "10.0.0.23",
    "port": "7878"
  },
  "radarrConfig": {
    "apiKey": "YOUR_RADARR_API_KEY",
    "basePath": "/api/v3",
    "port": "7878"
  },
  "sonarrConfig": {
    "apiKey": "YOUR_SONARR_API_KEY",
    "basePath": "/api/v3",
    "port": "8989"
  },
  "server": {
    "port": 3000
  }
}

Herramientas MCP disponibles

Este servidor proporciona las siguientes herramientas a Claude:

Cine

get_available_movies - Obtener una lista de películas con filtros opcionales
lookup_movie - Busca una película por título
get_movie_details - Obtenga información detallada sobre una película específica

Serie

get_available_series - Obtener una lista de series de TV con filtros opcionales
lookup_series - Busca una serie de televisión por título
get_series_details - Obtenga información detallada sobre una serie específica
get_series_episodes - Obtener episodios de una serie específica

Recursos

El servidor también proporciona recursos MCP estándar:

/movies - Explorar todas las películas disponibles
/series - Explorar todas las series de televisión disponibles

Opciones de filtrado

La mayoría de las herramientas admiten varias opciones de filtrado:

year - Filtrar por año de lanzamiento
watched - Filtrar por estado vigilado (verdadero/falso)
downloaded - Filtrar por estado de descarga (verdadero/falso)
watchlist : Filtrar por estado de la lista de seguimiento (verdadero/falso)
actors - Filtrar por nombre de actor/elenco
actresses - Filtrar por nombre de actriz (solo películas)

Ejemplos de consultas para Claude

Una vez que su servidor MCP esté conectado a Claude Desktop, puede hacer preguntas como:

"¿Qué películas de ciencia ficción del 2023 tengo?"
"Muéstrame programas de televisión protagonizados por Pedro Pascal"
"¿Tengo algún episodio de The Mandalorian sin ver?"
"Buscar películas con Tom Hanks que aún no he visto"
¿Cuántos episodios de Stranger Things tengo descargados?

Encontrar claves API

Clave API de Radarr

Abra Radarr en su navegador
Vaya a Configuración > General
Encuentra la sección "Clave API"
Copiar la clave API

Clave API de Sonarr

Abra Sonarr en su navegador
Vaya a Configuración > General
Encuentra la sección "Clave API"
Copiar la clave API

Interfaz de línea de comandos

El paquete proporciona una interfaz de línea de comandos:

radarr-sonarr-mcp configure - Ejecutar el asistente de configuración
radarr-sonarr-mcp start - Iniciar el servidor MCP
radarr-sonarr-mcp status - Mostrar la configuración actual

Desarrollo

Ejecución de pruebas

Para ejecutar el conjunto de pruebas:

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage
pytest --cov=radarr_sonarr_mcp

Desarrollo local

Para un desarrollo y pruebas rápidos:

# Run directly without installation
python run.py

Requisitos

Python 3.7+
FastMCP
Solicitudes
Pydantic

Notas

La función de estado de vigilancia/lista de vigilancia asume que se rastrean mediante mecanismos específicos de Radarr/Sonarr. Es posible que deba adaptarla a su configuración específica.
Por razones de seguridad, se recomienda ejecutar este servidor solo en su red local.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo basado en Python que permite a los asistentes de IA como Claude acceder y consultar su colección de películas y programas de TV a través de las API de Radarr y Sonarr.

Related Resources

Reddit Discussion about this server

Radarr and Sonarr MCP Server