Skip to main content
Glama
deenesjakoruzh
thesammykins

FlixBridge

by thesammykins
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

FlixBridge

npm version npm downloads License: MIT

媒体管理 MCP 服务器
将您的 AI 助手连接到电视节目和电影管理服务

FlixBridge 是一个模型上下文协议 (MCP) 服务器，用于连接 AI 助手与媒体管理服务。它提供了一个统一的界面，用于监控下载、管理媒体库以及自动化媒体工作流。

✨ 核心功能

  • 🎬 多服务支持 - 支持电视节目、电影和下载客户端

  • 🔄 实时监控 - 队列状态、系统健康状况和诊断

  • 🤖 智能自动化 - 自动修复卡住的下载并优化工作流

  • 🏢 多实例就绪 - 支持质量分级、内容类型和多环境

  • 🔍 智能搜索 - 使用智能质量配置查找并添加新内容

  • 📊 统一仪表盘 - 在一个视图中查看所有服务

  • 🐛 高级调试 - 全面的日志记录和诊断功能

  • ⚡ 高性能 - 高效、轻量级，优先使用 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

或者使用基于 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-in-env 映射。

基于 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

📚 文档

🤝 贡献

  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