mediabox-mcp

Mediabox MCP는 Model Context Protocol(MCP)을 통해 관리 계층을 노출하는 자체 호스팅 미디어 서버 스택으로 제시됩니다. 저장소는 세 가지 실행 방식을 설명합니다. 첫 번째는 Windows/macOS 및 로컬 우선 설치용 Tauri 데스크톱 애플리케이션입니다. 두 번째는 Linux 서버, VPS, 헤드리스 배포를 위한 대화형 CLI 마법사인 npx create-mediabox입니다. 세 번째는 Claude Desktop, ChatGPT, Gemini, OpenAI 호환 클라이언트 또는 OAuth 보호 Streamable HTTP을 통한 선택적 Telegram 봇에 연결할 수 있는 헤드리스 MCP 서버입니다. 세 인터페이스 모두 동일한 Docker 스택, @mediabox/core 오케스트레이션 파이프라인 및 동일한 MCP 도구를 공유합니다. 배포 모드는 홈 네트워크용 Local, Caddy와 자동 HTTPS가 포함된 VPS, 포트 개방 없이 공개 접근이 가능한 Cloudflare Tunnel입니다. 요구사항은 Docker, Docker Compose, Node.js 20 이상입니다. 데스크톱 빌드에는 Tauri용 Rust와 Node 사이드카 컴파일용 Bun도 필요합니다. CLI는 Docker를 시작하지 않고 구성만 작성하는 --generate-only 플래그와 기여자가 복제된 저장소에서 실행하는 데 목적한 --local-build 플래그를 지원합니다. 스택은 Jellyfin, Sonarr, Radarr, qBittorrent, PyLoad을 중심으로 구성되며, 아키텍처에는 Prowlarr와 FlareSolverr도 포함되어 있습니다. Caddy나 nginx 같은 역방향 프록시가 서비스를 전면에서 지원합니다. MCP 서버는 /mcp, /api/dashboard, /api/chat, /api/setup 엔드포인트를 노출하며, README에는 30개 MCP 도구가 Jellyfin, Library, Sonarr, Radarr, Downloads, Maintenance 카테고리로 분류되어 나열됩니다. 예시로는 서버 상태 및 활동 로그, 미디어 검색 및 상세 정보, 라이브러리 및 파일 관리, 자막 수정, 일괄 파일 이름 변경, 시리즈 및 영화 검색/상태/삭제/릴리스/잡기/가져오기/재색인, 직접 URL 및 PyLoad 다운로드, 다운로드 대기열 관리, 미디어 최적화 또는 정리 작업 등이 포함됩니다. 설정 흐름은 대략 열다섯 번의 수동 단계를 대체하는 것으로 설명됩니다. 배포 모드, 미디어 경로, 자격 증명, 시간대, 선택적 통합을 묻습니다. 그리고 .env, docker-compose.yml, VPS용 Caddyfile, qBittorrent 구성을 생성한 후 Docker 컨테이너를 시작하고 서비스 API를 통해 스택을 자동으로 구성합니다. 여기에는 Sonarr/Radarr/Prowlarr API 키 추출, Jellyfin 설정 마법사 실행, 관리자 사용자 및 API 키 생성, qBittorrent를 다운로드 클라이언트로 구성, 루트 폴더 추가, Prowlarr 인덱서 동기화, FlareSolverr 및 Jellyfin 미디어 라이브러리 설정, 웹 UI 자격 증명 설정이 포함됩니다. 저장소는 Prowlarr에서 토렌트 인덱서 추가는 수동 단계라고 명시합니다. 이 프로젝트는 MIT 라이선스이며, README는 영어와 스페인어로 제공됩니다.