Skip to main content
Glama
deenesjakoruzh
thesammykins

FlixBridge

by thesammykins
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

FlixBridge

npm version npm downloads License: MIT

メディア管理MCPサーバー
AIアシスタントをテレビ番組や映画の管理サービスに接続します

FlixBridgeは、AIアシスタントとメディア管理サービスを橋渡しするModel Context Protocol (MCP) サーバーです。ダウンロードの監視、ライブラリの管理、メディアワークフローの自動化のための統合インターフェースを提供します。

✨ 主な機能

  • 🎬 マルチサービスサポート - テレビ番組、映画、ダウンロードクライアント

  • 🔄 リアルタイム監視 - キューの状態、システムヘルス、診断

  • 🤖 スマート自動化 - スタックしたダウンロードの自動修正とワークフローの最適化

  • 🏢 マルチインスタンス対応 - 品質ティア、コンテンツタイプ、環境

  • 🔍 インテリジェント検索 - スマートな品質プロファイルで新しいコンテンツを検索・追加

  • 📊 統合ダッシュボード - すべてのサービスを単一のビューで表示

  • 🐛 高度なデバッグ - 包括的なログと診断

  • ⚡ 高パフォーマンス - 効率的、軽量、TypeScriptファースト

Related MCP server: Apifox MCP Server

📦 インストール

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

または、複数のインスタンスに対してスラッグベースの設定を使用する場合:

# 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は、スラッグベースの検出機能を備えた環境変数のみの設定を使用します。設定ファイルやJSON-in-envマッピングは不要です。

スラッグベースのマルチインスタンス

  • 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> になります (スラッグは小文字化され、_ は - に変換されます)。

  • <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.

スラッグベースのマルチインスタンスセットアップを使用する場合は、エージェントに 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

📚 ドキュメント

🤝 貢献

  1. アーキテクチャガイド を読む

  2. AGENTS.md のエンジニアリング原則に従う

  3. TypeScriptの厳格モードを維持する

  4. 新機能のテストを追加する

  5. 提出前に npm run smoke を実行する

📄 ライセンス

MIT - 詳細は LICENSE ファイルを参照してください

🆘 ヘルプが必要ですか？

  1. トラブルシューティングガイド を確認する

  2. 診断を実行する: npm run smoke

  3. デバッグモードを有効にする: FLIX_BRIDGE_DEBUG=1

  4. メディア管理サービスのログを確認する

ホームメディア自動化コミュニティのために ❤️ を込めて作成されました

Install Server
A
license - permissive license
C
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
4wRelease cycle
10Releases (12mo)

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/thesammykins/FlixBridge'

If you have feedback or need assistance with the MCP directory API, please join our Discord server