Authorized YTDL MCP

ChatGPT 웹에서 본인 소유 또는 다운로드 허가를 받은 YouTube 영상, 음원, 재생목록을 MP4/MP3로 준비하는 원격 MCP App입니다. ~/Desktop/ytdl_cli의 yt-dlp + ffmpeg 방식을 서버용으로 옮기고, ChatGPT 채팅 안에 실시간 진행 화면과 미디어 플레이어가 나타나는 MCP Apps 위젯을 추가했습니다.

제공 도구

• inspect_youtube_url: 제목, 채널, 길이, 라이브 여부 확인

• start_download: 단일 영상/음원의 비동기 작업 시작

• start_playlist_download: 재생목록 전체를 병렬 대기열에 추가

• get_download_status: 개별 항목 진행률 조회

• get_batch_status: 전체 및 모든 항목의 최신 상태 조회

• render_download_widget: 채팅 안에 실시간 진행 UI와 플레이어 표시

위젯은 1초마다 자동 갱신하며 각 항목의 받은 용량, 전체 예상 용량, 속도, ETA, 진행률과 상태를 보여줍니다. 완료된 MP4/MP3는 위젯에서 바로 재생하거나 내려받을 수 있습니다. 앱에서 정한 파일 용량 상한은 없으며, 동시 작업은 기본 3개, 링크 유효시간은 30분입니다. 라이브 스트림은 지원하지 않습니다.

애플리케이션의 용량 제한을 없애도 호스팅 서버의 디스크·메모리·대역폭 한계는 없어지지 않습니다. 특히 무료 Render 인스턴스는 대용량 영상과 큰 재생목록을 안정적으로 처리하는 무제한 저장소가 아닙니다.

Related MCP server: LLM Jukebox

로컬 실행

Python 3.10 이상과 ffmpeg가 필요합니다.

cd ~/Desktop/ytdl_mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
ALLOWED_HOSTS=localhost,127.0.0.1 \
  .venv/bin/uvicorn server:app --host 127.0.0.1 --port 8000

• MCP URL: http://127.0.0.1:8000/mcp

• 상태 확인: http://127.0.0.1:8000/health

MCP Inspector에서는 전송 방식을 Streamable HTTP로 선택합니다.

npx @modelcontextprotocol/inspector

Render 무료 배포

1. 이 폴더를 새 GitHub 저장소에 push합니다.

2. Render에서 New → Blueprint를 선택하고 저장소를 연결합니다.

3. 환경 변수를 다음처럼 설정합니다.

   • PUBLIC_BASE_URL=https://서비스이름.onrender.com

   • ALLOWED_HOSTS=서비스이름.onrender.com

   • MAX_CONCURRENT_JOBS=3

   • JOB_TTL_SECONDS=1800

4. 배포 후 다음 주소를 확인합니다.

   • 상태: https://서비스이름.onrender.com/health

   • MCP: https://서비스이름.onrender.com/mcp

Render 무료 인스턴스는 유휴 시 정지하고 로컬 디스크가 휘발됩니다. 완료 파일은 기본 30분 후 삭제되고, 서버가 재시작되면 진행 중 작업과 파일이 사라집니다. 대용량 영상 전송은 Render의 외부 트래픽 제한에 걸릴 수 있으므로 개인 테스트 규모로 사용하세요.

ChatGPT 웹에 연결

ChatGPT 웹의 Settings → Apps → Advanced settings → Developer mode를 켠 뒤, 새 앱/커넥터의 원격 MCP URL로 https://서비스이름.onrender.com/mcp를 입력합니다. 계정 플랜과 워크스페이스 관리자 정책에 따라 메뉴와 허용 범위가 다를 수 있습니다.

예시 요청:

이 영상은 내가 만든 영상이고 다운로드 권한이 있어. 720p MP4로 준비해 줘: https://youtu.be/...

재생목록 예시:

이 재생목록 전체를 다운로드할 권한이 있어. 각 항목을 192kbps MP3로 준비하고 진행 화면을 보여줘: https://www.youtube.com/playlist?list=...

ChatGPT는 시작 도구 호출 후 render_download_widget을 호출합니다. 이후 위젯이 get_batch_status를 1초마다 직접 호출하므로 ChatGPT 답변을 계속 새로 만들지 않고 카드 내부의 진행 상태만 자연스럽게 갱신합니다.

운영 전 필수 보안

현재 구성은 개인 개발 테스트용입니다. URL을 아는 누구나 작업을 만들 수 있으므로 공개 배포·공개 등록 전에는 OAuth 2.1 사용자 인증, 사용자별 할당량, 외부 작업 저장소/오브젝트 스토리지, 모니터링을 추가해야 합니다. start_download의 authorized=true는 사용자 확인 기록이지 DRM 우회나 권리 검증 수단이 아닙니다.

YouTube 이용약관, 저작권, 지역 법률을 준수하고 허가되지 않은 콘텐츠는 처리하지 마세요.