FlixBridge
FlixBridge
メディア管理MCPサーバー
AIアシスタントをテレビ番組や映画の管理サービスに接続します
FlixBridgeは、AIアシスタントとメディア管理サービスを橋渡しするModel Context Protocol (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または、複数のインスタンスに対してスラッグベースの設定を使用する場合:
# 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_URLSONARR_API_KEYRADARR_URLRADARR_API_KEYSABNZBD_URLSABNZBD_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📚 ドキュメント
インストールとセットアップ - 要件とインストール
設定ガイド - すべての設定方法
使用ガイド - MCPクライアントの設定とワークフロー
APIリファレンス - 完全なツールドキュメント
マルチインスタンスセットアップ - 高度なマルチインスタンスパターン
トラブルシューティング - 一般的な問題と解決策
アーキテクチャガイド - 開発者向けの技術アーキテクチャ
🤝 貢献
アーキテクチャガイド を読む
AGENTS.mdのエンジニアリング原則に従うTypeScriptの厳格モードを維持する
新機能のテストを追加する
提出前に
npm run smokeを実行する
📄 ライセンス
MIT - 詳細は LICENSE ファイルを参照してください
🆘 ヘルプが必要ですか?
トラブルシューティングガイド を確認する
診断を実行する:
npm run smokeデバッグモードを有効にする:
FLIX_BRIDGE_DEBUG=1メディア管理サービスのログを確認する
ホームメディア自動化コミュニティのために ❤️ を込めて作成されました
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceA comprehensive Model Context Protocol server that bridges LLMs with self-hosted media services, enabling natural language control of TV shows, movies, downloads, and notifications while maintaining traditional API access.6AGPL 3.0
- AlicenseBqualityFmaintenanceA bridge server that connects Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients, enabling seamless integration between ACP-based AI agents and MCP-compatible tools like Claude Desktop.1624MIT
- AlicenseBqualityAmaintenanceA Model Context Protocol server that enables AI assistants to query and manage Plex Media Server content through natural language, providing library access, viewing statistics, and media management capabilities.5812550JavaScriptMIT
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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