Servidor MCP de pila de medios YARR

Un servidor integral de Protocolo de Contexto de Modelo (MCP) que conecta los Modelos de Lenguaje Grandes (LLM) con su pila de tecnología multimedia autoalojada. Este proyecto permite la automatización inteligente y el control del lenguaje natural de sus servicios multimedia, manteniendo al mismo tiempo el acceso programático tradicional.

🎯 Características principales

Control de lenguaje natural de servicios multimedia impulsado por LLM
🔌 Arquitectura modular para una fácil integración de servicios
Puerta de enlace API unificada para acceso tradicional
🎮 Interfaz web para control visual (planificado)
Acceso directo a la API sin middleware LLM
🧩 Sistema de plugins extensible para nuevos servicios

📚 Documentación

🏗️ Estructura del proyecto

Este monorepositorio está organizado en paquetes modulares, cada uno de los cuales cumple una finalidad específica:

📦 packages/server : Implementación del servidor MCP principal
🌐 packages/web : Interfaz de usuario web (planificada)
💬 packages/chatbot : Interfaz de chat LLM (planificada)
🔀 packages/api-gateway : enrutamiento de API y coordinación de servicios (planificado)

🔧 Servicios Integrados

✅ Actualmente compatible

Gotify - Gestión de notificaciones
Sonarr - Gestión de programas de televisión
Prowlarr - Gestión de indexadores
Overseerr - Gestión de solicitudes

🚧 Integraciones planificadas

Radarr - Gestión de películas
qBittorrent - Gestión de torrents
SABnzbd - Descargas de Usenet
Plex - Servidor multimedia
Tautulli - Estadísticas del servidor
TMDB - Base de datos de medios

📖 Documentación del servicio

🟢 Actualmente Integrado

Integración planificada

🧪 Desarrollo

Herramientas de prueba

Referencias del SDK

🏛️ Arquitectura

El proyecto sigue una arquitectura modular donde cada paquete de servicios contiene:

🔌 Implementación del cliente API
📝 Definiciones de tipos
🛠️ Herramientas MCP para la interacción con el servicio
🛣️ Rutas API

Esta arquitectura admite múltiples métodos de interacción:

Control impulsado por LLM : procesamiento del lenguaje natural para una gestión intuitiva de los medios
Acceso a API tradicional : llamadas API directas a través de la puerta de enlace unificada
Interfaz web : Panel de control visual para la gestión de servicios (planificado)
Interfaz de chatbot : interfaz de usuario conversacional para el control del servicio (planificado)

El diseño modular permite:

Fácil incorporación de nuevos servicios
Despliegue de servicios independientes
Métodos de interacción flexibles
Patrones de API consistentes en todos los servicios

🚀 Primeros pasos

Prerrequisitos

# Clone and setup repository
git clone https://github.com/jmagar/yarr
cd yarr
pnpm install

Configuración

Crear un archivo .env a partir de una plantilla:

cp .env.template .env

A continuación, agregue sus claves API de servicio:

# Sonarr Configuration
SONARR_URL=http://localhost:8989
SONARR_API_KEY=your_sonarr_api_key

# Prowlarr Configuration  
PROWLARR_URL=http://localhost:9696
PROWLARR_API_KEY=your_prowlarr_api_key

# Overseerr Configuration
OVERSEERR_URL=http://localhost:5055
OVERSEERR_API_KEY=your_overseerr_api_key

# Gotify Configuration
GOTIFY_URL=http://localhost:8080
GOTIFY_APP_TOKEN=your_gotify_app_token
GOTIFY_CLIENT_TOKEN=your_gotify_client_token  # Optional, for receiving messages

Configurar Claude Desktop:

Importante : utilice rutas completas en su configuración para garantizar que Claude Desktop pueda encontrar los ejecutables y el directorio del proyecto.

{
  "mcpServers": {
    "yarr": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\path\\to\\yarr\\packages\\server\\dist\\index.js"],
      "cwd": "C:\\path\\to\\yarr",
      "transport": {
        "type": "stdio"
      },
      "env": {
        "NODE_ENV": "production",
        "PROWLARR_URL": "http://localhost:9696",
        "PROWLARR_API_KEY": "your_prowlarr_api_key",
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your_sonarr_api_key",
        "OVERSEERR_URL": "http://localhost:5055",
        "OVERSEERR_API_KEY": "your_overseerr_api_key",
        "GOTIFY_URL": "http://localhost:8080",
        "GOTIFY_APP_TOKEN": "your_gotify_app_token",
        "GOTIFY_CLIENT_TOKEN": "your_gotify_client_token"
      }
    }
  }
}

Nota: reemplace C:\\path\\to\\yarr con la ruta del directorio de su proyecto actual.

Herramientas disponibles

Sonarr

// Series Management
sonarr:search              - Search for TV shows
sonarr:list-series         - List all monitored TV series  
sonarr:series-details      - Get detailed information about a series
sonarr:add-series         - Add a new series to monitor
sonarr:monitor-season     - Monitor or unmonitor a season
sonarr:list-profiles      - List quality and language profiles
sonarr:upcoming          - Get upcoming episodes
sonarr:queue             - Get current download queue
sonarr:remove-from-queue - Remove item from download queue

Merodeador

prowlarr:search           - Search across all indexers
prowlarr:list-indexers    - List configured indexers
prowlarr:indexer-stats    - Get indexer performance stats
prowlarr:check-config     - Validate Prowlarr connection

Supervisor

overseerr:search          - Search for movies and TV shows
overseerr:request         - Request a movie or TV show
overseerr:list-requests   - List media requests
overseerr:update-request  - Update request status
overseerr:trending        - Get trending media with recommendations
overseerr:available       - Get popular available media
overseerr:status          - Get system status

Gotify

gotify:messages:list      - List messages with pagination
gotify:messages:send      - Send a new message
gotify:messages:delete    - Delete a message by ID
gotify:messages:cleanup   - Delete old messages
gotify:apps:list         - List all applications
gotify:apps:create       - Create a new application
gotify:clients:list      - List all clients
gotify:clients:create    - Create a new client
gotify:health           - Check Gotify server health
gotify:stats            - Get Gotify statistics

YARR Media Stack MCP Server

Integrations