FlixBridge

MCP-сервер для управления медиаконтентом
Подключите своего ИИ-ассистента к сервисам управления телешоу и фильмами

FlixBridge — это сервер протокола контекста модели (MCP), который связывает ИИ-ассистентов со службами управления медиаконтентом. Он предоставляет единый интерфейс для мониторинга загрузок, управления библиотеками и автоматизации рабочих процессов с медиафайлами.

✨ Ключевые особенности

• 🎬 Поддержка нескольких сервисов — телешоу, фильмы и клиенты для загрузки

• 🔄 Мониторинг в реальном времени — состояние очереди, работоспособность системы и диагностика

• 🤖 Умная автоматизация — автоматическое исправление зависших загрузок и оптимизация рабочих процессов

• 🏢 Поддержка нескольких экземпляров — уровни качества, типы контента, окружения

• 🔍 Интеллектуальный поиск — поиск и добавление нового контента с использованием профилей качества

• 📊 Единая панель управления — единый обзор всех ваших сервисов

• 🐛 Расширенная отладка — комплексное логирование и диагностика

• ⚡ Высокая производительность — эффективный, легкий, ориентированный на TypeScript

Related MCP server: Trakt

📦 Установка

Через npm (рекомендуется)

# Install globally
npm install -g @thesammykins/flixbridge

# Or install locally in your project
npm install @thesammykins/flixbridge

📦 Посмотреть на npm

Из исходного кода

# Clone the repository
git clone https://github.com/thesammykins/FlixBridge.git
cd FlixBridge

# Install dependencies and build
npm install && npm run build

🚀 Быстрый старт

# 1. Configure your services via environment variables
export SONARR_URL="http://localhost:8989"
export SONARR_API_KEY="your-sonarr-api-key"
export RADARR_URL="http://localhost:7878"
export RADARR_API_KEY="your-radarr-api-key"
# Optional downloader
export SABNZBD_URL="http://localhost:8080"
export SABNZBD_API_KEY="your-sabnzbd-api-key"

# 2. Build and run
npm run build
npm start

Или с использованием конфигурации на основе slug для нескольких экземпляров:

# Multiple Sonarr instances
export SONARR_HD_URL="http://localhost:8989"
export SONARR_HD_API_KEY="your-hd-sonarr-key"
export SONARR_4K_URL="http://localhost:8990"
export SONARR_4K_API_KEY="your-4k-sonarr-key"

# Multiple Radarr instances  
export RADARR_MAIN_URL="http://localhost:7878"
export RADARR_MAIN_API_KEY="your-main-radarr-key"
export RADARR_UHD_URL="http://localhost:7879"
export RADARR_UHD_API_KEY="your-uhd-radarr-key"

npm start

⚙️ Конфигурация

FlixBridge v0.3.x использует конфигурацию только через переменные окружения с обнаружением на основе slug. Файлы конфигурации и маппинг JSON-в-переменные не требуются.

Несколько экземпляров на основе slug

• Sonarr: SONARR_<SLUG>_URL, SONARR_<SLUG>_API_KEY, SONARR_<SLUG>_NAME (опционально)

• Radarr: RADARR_<SLUG>_URL, RADARR_<SLUG>_API_KEY, RADARR_<SLUG>_NAME (опционально)

• SABnzbd: SABNZBD_<SLUG>_URL, SABNZBD_<SLUG>_API_KEY, SABNZBD_<SLUG>_NAME (опционально)

• Также принимаются префиксные псевдонимы: FLIX_BRIDGE_SONARR_<SLUG>_URL с _KEY или _API_KEY.

• Также принимаются префиксные псевдонимы для одного экземпляра, например FLIX_BRIDGE_SABNZBD_URL с FLIX_BRIDGE_SABNZBD_KEY.

Переменные для одного экземпляра (резервные)

• SONARR_URL

• SONARR_API_KEY

• RADARR_URL

• RADARR_API_KEY

• SABNZBD_URL

• SABNZBD_API_KEY

Пример для нескольких экземпляров

# Sonarr
export SONARR_MAIN_URL="http://sonarr-main:8989"
export SONARR_MAIN_API_KEY="{{SONARR_MAIN_KEY}}"
export SONARR_4K_URL="http://sonarr-4k:8989"
export SONARR_4K_API_KEY="{{SONARR_4K_KEY}}"

# Radarr
export RADARR_MAIN_URL="http://radarr-main:7878"
export RADARR_MAIN_API_KEY="{{RADARR_MAIN_KEY}}"
export RADARR_UHD_URL="http://radarr-uhd:7878"
export RADARR_UHD_API_KEY="{{RADARR_UHD_KEY}}"

# SABnzbd (optional)
export SABNZBD_MAIN_URL="http://sab-main:8080"
export SABNZBD_MAIN_API_KEY="{{SAB_MAIN_KEY}}"

Примечания:

• Имена сервисов по умолчанию имеют вид sonarr-<slug> / radarr-<slug> (slug в нижнем регистре, _ → -).

• Если вы установите <KIND>_<SLUG>_NAME, это переопределит итоговое имя (убедитесь, что оно содержит "sonarr"/"radarr" для прохождения текущей проверки).

• Резервные переменные для одного экземпляра (SONARR_URL/RADARR_URL/SABNZBD_URL) по-прежнему работают для простых настроек.

🛠️ Доступные инструменты

⚠️ Важно: Всегда сначала вызывайте list_services, чтобы обнаружить доступные сервисы, прежде чем использовать любые другие инструменты.

Обнаружение сервисов

• list_services — обнаружение всех настроенных сервисов и загрузчиков

Основные операции

• system_status — информация о работоспособности и версии

• queue_list — очередь загрузок с отслеживанием прогресса

• queue_grab — принудительный повтор/захват конкретных загрузок

• queue_diagnostics — анализ зависших элементов; передайте autoFix:false для проверок только для чтения

• remove_content — предварительный просмотр и удаление элементов из очереди, библиотеки или загрузчика с подтверждением

• root_folders — места хранения и свободное пространство

Управление медиаконтентом

• search — поиск новых сериалов/фильмов для добавления

• add_new — добавление медиаконтента с интеллектуальными профилями качества

• quality_profiles — список доступных конфигураций качества

• history_detail — история загрузок и импорта

• import_issues — обнаружение зависших загрузок и проблем с импортом

Инструменты для нескольких сервисов

• all_services_diagnostics — запуск диагностики для всех экземпляров

• download_status — единый статус для всех сервисов и загрузчиков

• server_metrics — локальные метрики операций и статус работоспособности

Безопасность в продакшене: queue_diagnostics и all_services_diagnostics по умолчанию имеют autoFix:true; явно передавайте autoFix:false для базовых проверок в продакшене только для чтения. Используйте remove_content с dryRun:true сначала и выполняйте только с возвращенным confirmationToken после проверки предварительного просмотра.

🔧 Настройка MCP-клиента

Промпт для установки через агент

Используйте этот промпт с вашим агентом кодирования, чтобы установить FlixBridge и получить готовую к вставке конфигурацию MCP:

Install and configure FlixBridge MCP for me.

Requirements:
1) Install package: @thesammykins/flixbridge
2) Generate MCP config for Claude Desktop using command "npx" and args ["@thesammykins/flixbridge"]
3) Include these env vars in the config with my values:
   - SONARR_URL
   - SONARR_API_KEY
   - RADARR_URL
   - RADARR_API_KEY
   - SABNZBD_URL (optional)
   - SABNZBD_API_KEY (optional)
4) Return only:
   - exact install command(s)
   - exact claude_desktop_config.json snippet
   - a 3-step verification checklist
5) After setup, remind me to call list_services first.

Если вы используете настройку для нескольких экземпляров на основе slug, попросите агента использовать переменные SONARR_<SLUG>_*, RADARR_<SLUG>_* и SABNZBD_<SLUG>_*.

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "flixbridge": {
      "command": "npx",
      "args": ["@thesammykins/flixbridge"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key"
      }
    }
  }
}

Альтернатива: Глобальная установка

# Install globally for easier usage
npm install -g @thesammykins/flixbridge

Затем используйте с Claude Desktop, предоставив переменные окружения (стандартные или через маппинг):

{
  "mcpServers": {
    "flixbridge": {
      "command": "flixbridge",
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key",
        "SABNZBD_URL": "http://localhost:8080",
        "SABNZBD_API_KEY": "your-sabnzbd-api-key"
      }
    }
  }
}

Настройка для одного экземпляра (альтернатива)

export SONARR_URL="http://localhost:8989"
export SONARR_API_KEY="your-sonarr-api-key"
export RADARR_URL="http://localhost:7878" 
export RADARR_API_KEY="your-radarr-api-key"
export SABNZBD_URL="http://localhost:8080"
export SABNZBD_API_KEY="your-sabnzbd-api-key"

🐛 Отладка

Включите комплексное логирование отладки:

FLIX_BRIDGE_DEBUG=1 npm run dev

🧪 Тестирование

# Basic functionality test
npm run smoke

# Test with debug output  
FLIX_BRIDGE_DEBUG=1 npm run smoke

📚 Документация

• Установка и настройка — требования и установка

• Руководство по конфигурации — все методы настройки

• Руководство по использованию — настройка MCP-клиента и рабочие процессы

• Справочник API — полная документация по инструментам

• Настройка нескольких экземпляров — продвинутые шаблоны для нескольких экземпляров

• Устранение неполадок — распространенные проблемы и решения

• Руководство по архитектуре — техническая архитектура для разработчиков

🤝 Участие в разработке

1. Прочитайте Руководство по архитектуре

2. Следуйте инженерным принципам в AGENTS.md

3. Поддерживайте строгий режим TypeScript

4. Добавляйте тесты для новых функций

5. Запустите npm run smoke перед отправкой

📄 Лицензия

MIT — подробности см. в файле LICENSE

🆘 Нужна помощь?

1. Проверьте руководство по устранению неполадок

2. Запустите диагностику: npm run smoke

3. Включите режим отладки: FLIX_BRIDGE_DEBUG=1

4. Просмотрите логи ваших сервисов управления медиаконтентом

Создано с ❤️ для сообщества автоматизации домашнего медиаконтента