mediabox-mcp

Mediabox MCP se présente comme une pile de serveur multimédia auto-hébergée dont la couche de gestion est exposée via le Model Context Protocol (MCP). Le dépôt décrit trois façons de l'exécuter : une application desktop Tauri pour Windows/macOS et les installations en local ; un assistant CLI interactif, npx create-mediabox, destiné aux serveurs Linux, VPS et déploiements headless ; et un serveur MCP headless connectable à Claude Desktop, ChatGPT, Gemini, un client compatible OpenAI, ou un bot Telegram optionnel via HTTP Streamable protégé par OAuth. Les trois surfaces partagent la même pile Docker, le pipeline d'orchestration @mediabox/core et les mêmes outils MCP. Les modes de déploiement incluent Local pour les réseaux domestiques, VPS avec Caddy et HTTPS automatique, et Cloudflare Tunnel pour un accès public sans ouvrir de ports. Les prérequis indiqués sont Docker, Docker Compose et Node.js 20 ou supérieur. Les builds desktop nécessitent également Rust pour Tauri et Bun pour compiler le sidecar Node. Le CLI prend en charge des drapeaux tels que --generate-only pour écrire la configuration sans démarrer Docker, tandis que --local-build s'adresse aux contributeurs exécutant depuis un dépôt cloné. La pile repose sur Jellyfin, Sonarr, Radarr, qBittorrent et PyLoad, Prowlarr et FlareSolverr apparaissant également dans l'architecture. Un proxy inverse tel que Caddy ou nginx fait face aux services. Le serveur MCP expose /mcp, /api/dashboard, /api/chat et /api/setup, et le README répertorie 30 outils MCP regroupés en catégories Jellyfin, Bibliothèque, Sonarr, Radarr, Téléchargements et Maintenance. Parmi les fonctionnalités figurent l'état du serveur et les journaux d'activité, la recherche et les détails multimédias, la gestion de bibliothèque et des fichiers, la correction de sous-titres, le renommage en lot, la recherche/le statut/la suppression/les releases/l'import/la resynchronisation de séries et films, les téléchargements directs par URL et PyLoad, la gestion des files d'attente de téléchargement, ainsi que les tâches d'optimisation ou de nettoyage multimédia. Le processus de configuration vise à remplacer environ quinze étapes manuelles. Il demande le mode de déploiement, les chemins multimédias, les identifiants, le fuseau horaire et les intégrations optionnelles ; génère les fichiers .env, docker-compose.yml, un Caddyfile pour VPS et la configuration qBittorrent ; démarre les conteneurs Docker ; puis configure automatiquement la pile via les API de service. Cela inclut l'extraction des clés API Sonarr/Radarr/Prowlarr, l'exécution de l'assistant de configuration Jellyfin, la création d'un utilisateur administrateur et d'une clé API, la configuration de qBittorrent comme client de téléchargement, l'ajout de dossiers racines, la synchronisation des indexeurs Prowlarr, la configuration de FlareSolverr et des bibliothèques multimédias Jellyfin, et la définition des identifiants de l'interface web. Le dépôt indique que l'ajout d'indexeurs torrent dans Prowlarr reste une étape manuelle. Le projet est sous licence MIT et le README est disponible en anglais et en espagnol.