MCP yt-dlp Server

yt-dlp를 사용하여 비디오와 스트림을 다운로드하기 위한 Model Context Protocol (MCP) 서버입니다. 이 서버는 MCP 호환 클라이언트(예: Claude Desktop)가 YouTube 및 1000개 이상의 지원 사이트에서 비디오를 다운로드하고, 오디오를 추출하고, 자막을 다운로드하고, 라이브 스트림을 캡처할 수 있게 합니다.

크레딧

이 프로젝트는 yt-dlp 팀의 놀라운 작업을 기반으로 구축되었습니다. yt-dlp는 수천 개의 사이트를 지원하는 기능이 풍부한 명령줄 오디오/비디오 다운로더입니다. yt-dlp에 대한 자세한 내용은 GitHub 저장소 또는 위키를 방문하세요.

Related MCP server: MCP YouTube Downloader

기능

• 비디오 다운로드: YouTube 및 1000개 이상의 지원 사이트에서 비디오 다운로드

• 스트림 다운로드: 라이브 스트림 및 HLS/m3u8 스트림 캡처

• 비디오 정보: 다운로드하지 않고 메타데이터 가져오기

• 포맷 목록: 비디오에 사용 가능한 모든 포맷 나열

• 검색: yt-dlp 추출기를 통해 비디오 직접 검색

• 오디오 추출: 포맷 변환을 통한 오디오 전용 다운로드 (MP3, M4A, WAV, FLAC)

• 자막: 여러 언어로 자막 다운로드

• 재생 목록 지원: 전체 또는 일부 재생 목록 다운로드

사전 요구 사항

• Node.js 18+

• yt-dlp가 서버와 동일한 디렉토리(또는 PATH)에 설치되어 있고 사용 가능해야 합니다.

설치 가이드

1단계: Node.js 설치

nodejs.org에서 Node.js 18+를 다운로드하여 설치합니다.

설치 확인:

node --version
npm --version

2단계: yt-dlp 다운로드 (간편 방법)

최신 yt-dlp를 올바른 디렉토리에 자동으로 다운로드하는 설정 스크립트를 제공합니다.

Windows: setup.bat을 더블클릭하거나 명령 프롬프트에서 실행합니다:

setup.bat

Linux / macOS:

chmod +x setup.sh
./setup.sh

스크립트는 다음을 수행합니다:

• 운영 체제 감지

• 최신 yt-dlp 바이너리 다운로드

• MCP 서버와 동일한 디렉토리에 배치

• 설치 확인

2단계 대안: 수동 다운로드

yt-dlp를 수동으로 설치하려면:

Windows:

1. 최신 릴리스에서 yt-dlp.exe를 다운로드합니다.

2. yt-dlp.exe를 MCP 서버와 동일한 디렉토리에 배치합니다.

macOS:

curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod a+rx /usr/local/bin/yt-dlp

Linux:

sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

Python (모든 플랫폼):

pip install yt-dlp

더 많은 설치 옵션은 yt-dlp 설치 가이드를 참조하세요.

3단계: 저장소 복제

git clone https://github.com/timyee22/yt-dlp-MCP.git
cd yt-dlp-MCP

4단계: 종속성 설치

npm install

5단계: MCP 클라이언트 구성

MCP 클라이언트 구성에 서버를 추가합니다:

Claude Desktop (Windows): %APPDATA%\Claude\settings.json을 편집합니다:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["C:\\path\\to\\yt-dlp-MCP\\index.js"]
    }
  }
}

Claude Desktop (macOS/Linux): ~/Library/Application Support/Claude/settings.json(macOS) 또는 해당 구성 경로를 편집합니다:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["/path/to/yt-dlp-MCP/index.js"]
    }
  }
}

중요: yt-dlp.exe(Windows) 또는 yt-dlp(macOS/Linux)가 다음 중 하나인지 확인하세요:

• index.js와 동일한 디렉토리에 있거나

• 시스템 PATH에서 사용 가능해야 합니다.

6단계: Claude Desktop 다시 시작

구성을 추가한 후 Claude Desktop을 다시 시작하여 새 MCP 서버를 로드합니다.

사용법

구성이 완료되면 Claude에게 다음과 같이 요청할 수 있습니다:

• "이 YouTube 비디오를 다운로드해 줘: [URL]"

• "이 비디오에서 오디오만 MP3로 다운로드해 줘"

• "이 비디오를 다운로드하지 않고 정보를 가져와 줘"

• "이 비디오에 사용 가능한 모든 포맷을 나열해 줘"

• "YouTube에서 [topic]에 관한 비디오를 검색해 줘"

• "이 비디오의 스페인어 자막을 다운로드해 줘"

사용 가능한 도구

download_video

URL에서 비디오를 다운로드합니다.

매개변수:

• url (필수): 비디오 URL

• outputDir: 출력 디렉토리 (기본값: 현재 디렉토리)

• format: 포맷 선택 (기본값: "best")

• quality: 비디오 품질 (예: "1080p", "720p")

• audioOnly: 오디오만 다운로드 (기본값: false)

• audioFormat: 추출할 오디오 포맷 (기본값: "mp3")

• subtitles: 자막 다운로드 (기본값: false)

• subtitleLangs: 자막 언어 (기본값: "en")

• playlistStart/playlistEnd: 재생 목록 범위

• noPlaylist: 단일 비디오만 다운로드 (기본값: false)

• additionalArgs: 추가 yt-dlp 인수

예시:

YouTube 비디오 다운로드:

{
  "url": "https://www.youtube.com/watch?v=...",
  "quality": "1080p",
  "subtitles": true
}

오디오만 다운로드:

{
  "url": "https://www.youtube.com/watch?v=...",
  "audioOnly": true,
  "audioFormat": "mp3"
}

download_stream

라이브 스트림 또는 HLS 스트림을 다운로드합니다.

매개변수:

• url (필수): 스트림 URL

• outputDir: 출력 디렉토리

• duration: 캡처 시간(초)

• format: 포맷 기본 설정 (기본값: "best")

• outputName: 사용자 지정 출력 파일 이름

• hlsUseMpegts: HLS에 MPEG-TS 사용 (기본값: true)

• additionalArgs: 추가 인수

get_video_info

다운로드하지 않고 비디오 메타데이터를 가져옵니다.

매개변수:

• url (필수): 비디오 URL

• flatPlaylist: 더 빠른 재생 목록 정보 (기본값: false)

list_formats

URL에 사용 가능한 모든 포맷을 나열합니다.

매개변수:

• url (필수): 비디오 URL

search_videos

yt-dlp 추출기를 사용하여 비디오를 검색합니다.

매개변수:

• query (필수): 검색어

• extractor: 검색 추출기 접두사 (기본값: "ytsearch10")

• getInfo: 상세 정보 가져오기 (기본값: true)

예시:

{
  "query": "programming tutorials",
  "extractor": "ytsearch5"
}

update_yt_dlp

yt-dlp를 최신 버전으로 업데이트합니다.

지원 사이트

yt-dlp는 다음을 포함하여 1000개 이상의 사이트를 지원합니다:

• YouTube

• Twitch

• Vimeo

• Twitter/X

• Instagram

• TikTok

• Facebook

• SoundCloud

• 그 외 다수...

전체 목록은 yt-dlp 지원 사이트를 참조하세요.

문제 해결

yt-dlp를 찾을 수 없음

• yt-dlp.exe(Windows) 또는 yt-dlp(macOS/Linux)가 서버와 동일한 디렉토리 또는 PATH에 있는지 확인하세요.

• Windows에서는 디렉토리를 PATH 환경 변수에 추가해야 할 수 있습니다.

Node.js 오류

• Node.js 18+가 설치되어 있는지 확인하세요: node --version

• 종속성이 설치되어 있는지 확인하세요: npm install

포맷을 사용할 수 없음

• 일부 비디오에는 요청한 포맷이 없을 수 있습니다. list_formats를 사용하여 사용 가능한 옵션을 확인하세요.

• YouTube는 일부 포맷을 제한할 수 있습니다. 다른 품질 설정을 시도해 보세요.

라이선스

Unlicense

감사의 글

• yt-dlp - 이것을 가능하게 한 강력한 비디오 다운로더

• Model Context Protocol - AI 어시스턴트가 도구를 사용할 수 있게 하는 프로토콜