FlixBridge
FlixBridge
미디어 관리 MCP 서버
AI 어시스턴트를 TV 쇼 및 영화 관리 서비스에 연결하세요
FlixBridge는 AI 어시스턴트와 미디어 관리 서비스를 연결하는 MCP(Model Context Protocol) 서버입니다. 다운로드 모니터링, 라이브러리 관리, 미디어 워크플로우 자동화를 위한 통합 인터페이스를 제공합니다.
✨ 주요 기능
🎬 다중 서비스 지원 - TV 쇼, 영화 및 다운로드 클라이언트
🔄 실시간 모니터링 - 대기열 상태, 시스템 상태 및 진단
🤖 스마트 자동화 - 멈춘 다운로드 자동 수정 및 워크플로우 최적화
🏢 다중 인스턴스 준비 - 품질 계층, 콘텐츠 유형, 환경
🔍 지능형 검색 - 스마트 품질 프로필로 새 콘텐츠 찾기 및 추가
📊 통합 대시보드 - 모든 서비스에 대한 단일 뷰
🐛 고급 디버깅 - 포괄적인 로깅 및 진단
⚡ 고성능 - 효율적이고 가벼운, 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(선택 사항)접두사가 붙은 별칭도 허용됩니다:
_KEY또는_API_KEY가 포함된FLIX_BRIDGE_SONARR_<SLUG>_URL.단일 인스턴스 접두사 별칭도 허용됩니다 (예:
FLIX_BRIDGE_SABNZBD_KEY가 포함된FLIX_BRIDGE_SABNZBD_URL).
단일 인스턴스 대체 변수
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