Об этом проекте

Mediabox MCP представлен как автономный стек медиа-сервера, уровень управления которым открыт через Model Context Protocol (MCP). В репозитории описаны три способа его запуска: настольное приложение Tauri для Windows/macOS и локальных установок; интерактивный CLI-мастер npx create-mediabox, предназначенный для Linux-серверов, VPS и развертываний без графического интерфейса; и headless-сервер MCP, который можно подключить к Claude Desktop, ChatGPT, Gemini, клиенту, совместимому с OpenAI, или опциональному Telegram-боту через защищенный OAuth Streamable HTTP. Все три интерфейса используют один и тот же стек Docker, конвейер оркестрации @mediabox/core и одинаковые инструменты MCP. Режимы развертывания включают Local для домашних сетей, VPS с Caddy и автоматическим HTTPS, а также Cloudflare Tunnel для публичного доступа без открытия портов. Указанные требования: Docker, Docker Compose и Node.js версии 20 или новее. Для сборки настольных версий дополнительно требуются Rust для Tauri и Bun для компиляции sidecar-модуля Node.js. CLI поддерживает такие флаги, как --generate-only для записи конфигурации без запуска Docker, а --local-build предназначен для участников, работающих с клонированным репозиторием. Стек построен вокруг Jellyfin, Sonarr, Radarr, qBittorrent и PyLoad, при этом Prowlarr и FlareSolverr также представлены в архитектуре. Сервисы находятся за обратным прокси, таким как Caddy или nginx. Сервер MCP предоставляет эндпоинты /mcp, /api/dashboard, /api/chat и /api/setup, а в README перечислены 30 инструментов MCP, сгруппированных в категории Jellyfin, Library, Sonarr, Radarr, Downloads и Maintenance. Примеры включают статус сервера и журналы активности, поиск и детали медиа, управление библиотеками и файлами, исправление субтитров, пакетное переименование, поиск/статус/удаление/релизы/захват/импорт/повторное сканирование для сериалов и фильмов, прямые загрузки по URL и через PyLoad, управление очередью загрузок, а также задачи оптимизации или очистки медиа. Процесс настройки описан как замена примерно пятнадцати ручных шагов. Он запрашивает режим развертывания, пути к медиа, учетные данные, часовой пояс и опциональные интеграции; генерирует .env, docker-compose.yml, файл конфигурации Caddy для VPS и конфигурацию qBittorrent; запускает контейнеры Docker; затем автоматически настраивает стек через API сервисов. Это включает извлечение API-ключей Sonarr/Radarr/Prowlarr, запуск мастера настройки Jellyfin, создание пользователя администратора и API-ключа, настройку qBittorrent в качестве клиента загрузки, добавление корневых папок, синхронизацию индексаторов Prowlarr, настройку FlareSolverr и медиабиблиотек Jellyfin, а также установку учетных данных веб-интерфейса. В репозитории отмечается, что добавление торрент-индексаторов в Prowlarr остается ручным шагом. Проект распространяется под лицензией MIT, а README доступен на английском и испанском языках.