mediabox-mcp

Mediabox MCP se presenta como un stack de servidor multimedia autoalojado cuya capa de gestión se expone a través del Protocolo de Contexto de Modelo (MCP). El repositorio describe tres formas de ejecutarlo: una aplicación de escritorio Tauri para Windows/macOS e instalaciones locales primero; un asistente CLI interactivo, npx create-mediabox, pensado para servidores Linux, VPS y despliegues sin interfaz; y un servidor MCP sin interfaz que se puede conectar a Claude Desktop, ChatGPT, Gemini, un cliente compatible con OpenAI o un bot de Telegram opcional a través de HTTP transmisible protegido por OAuth. Las tres superficies comparten el mismo stack de Docker, el pipeline de orquestación @mediabox/core y las mismas herramientas MCP. Los modos de despliegue incluyen Local para redes domésticas, VPS con Caddy y HTTPS automático, y Cloudflare Tunnel para acceso público sin necesidad de abrir puertos. Los requisitos indicados son Docker, Docker Compose y Node.js 20 o versiones posteriores. Las compilaciones de escritorio necesitan además Rust para Tauri y Bun para compilar el proceso secundario de Node. La CLI admite parámetros como --generate-only para escribir la configuración sin iniciar Docker, mientras que --local-build está dirigido a colaboradores que ejecutan el proyecto desde un repositorio clonado. El stack se centra en Jellyfin, Sonarr, Radarr, qBittorrent y PyLoad, con Prowlarr y FlareSolverr también presentes en la arquitectura. Un proxy inverso como Caddy o nginx frontaliza los servicios. El servidor MCP expone las rutas /mcp, /api/dashboard, /api/chat y /api/setup, y el README lista 30 herramientas MCP agrupadas en las categorías Jellyfin, Biblioteca, Sonarr, Radarr, Descargas y Mantenimiento. Entre los ejemplos se incluyen estado del servidor y registros de actividad, búsqueda y detalles de contenido multimedia, gestión de biblioteca y archivos, corrección de subtítulos, renombrado por lotes, búsqueda, estado, eliminación, lanzamientos, captura, importación y reescanado de series y películas, descargas directas por URL y a través de PyLoad, gestión de la cola de descargas, y trabajos de optimización o limpieza de contenido multimedia. El flujo de configuración está descrito como un reemplazo de aproximadamente quince pasos manuales. Solicita el modo de despliegue, rutas de contenido multimedia, credenciales, zona horaria e integraciones opcionales; genera los archivos .env, docker-compose.yml, un Caddyfile para VPS y la configuración de qBittorrent; inicia los contenedores de Docker; y luego configura automáticamente el stack a través de las API de los servicios. Esto incluye extraer las claves API de Sonarr/Radarr/Prowlarr, ejecutar el asistente de configuración de Jellyfin, crear un usuario administrador y su clave API, configurar qBittorrent como cliente de descarga, añadir carpetas raíz, sincronizar los indexadores de Prowlarr, configurar FlareSolverr y las bibliotecas de contenido de Jellyfin, y establecer las credenciales de la interfaz web. El repositorio indica que añadir indexadores de torrents en Prowlarr sigue siendo un paso manual. El proyecto tiene licencia MIT y el README está disponible en inglés y español.