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.

Related MCP server: Trakt

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

1. Clonar este repositorio:

   git clone https://github.com/yourusername/radarr-sonarr-mcp.git
   cd radarr-sonarr-mcp-python

2. Instalar el paquete:

   pip install -e .

Usando pip (próximamente)

pip install radarr-sonarr-mcp

Inicio rápido

1. Configurar el servidor:

   radarr-sonarr-mcp configure

   Siga las instrucciones para ingresar sus claves API de Radarr/Sonarr y otras configuraciones.

2. Iniciar el servidor:

   radarr-sonarr-mcp start

3. 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

1. Abra Radarr en su navegador

2. Vaya a Configuración > General

3. Encuentra la sección "Clave API"

4. Copiar la clave API

Clave API de Sonarr

1. Abra Sonarr en su navegador

2. Vaya a Configuración > General

3. Encuentra la sección "Clave API"

4. 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.