Skip to main content
Glama
deenesjakoruzh
thesammykins

FlixBridge

by thesammykins
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

FlixBridge

npm version npm downloads License: MIT

미디어 관리 MCP 서버
AI 어시스턴트를 TV 쇼 및 영화 관리 서비스에 연결하세요

FlixBridge는 AI 어시스턴트와 미디어 관리 서비스를 연결하는 MCP(Model Context Protocol) 서버입니다. 다운로드 모니터링, 라이브러리 관리, 미디어 워크플로우 자동화를 위한 통합 인터페이스를 제공합니다.

✨ 주요 기능

  • 🎬 다중 서비스 지원 - TV 쇼, 영화 및 다운로드 클라이언트

  • 🔄 실시간 모니터링 - 대기열 상태, 시스템 상태 및 진단

  • 🤖 스마트 자동화 - 멈춘 다운로드 자동 수정 및 워크플로우 최적화

  • 🏢 다중 인스턴스 준비 - 품질 계층, 콘텐츠 유형, 환경

  • 🔍 지능형 검색 - 스마트 품질 프로필로 새 콘텐츠 찾기 및 추가

  • 📊 통합 대시보드 - 모든 서비스에 대한 단일 뷰

  • 🐛 고급 디버깅 - 포괄적인 로깅 및 진단

  • ⚡ 고성능 - 효율적이고 가벼운, 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 (선택 사항)

  • 접두사가 붙은 별칭도 허용됩니다: _KEY 또는 _API_KEY가 포함된 FLIX_BRIDGE_SONARR_<SLUG>_URL.

  • 단일 인스턴스 접두사 별칭도 허용됩니다 (예: FLIX_BRIDGE_SABNZBD_KEY가 포함된 FLIX_BRIDGE_SABNZBD_URL).

단일 인스턴스 대체 변수

  • 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