MCP yt-dlp Server

yt-dlp を使用して動画やストリームをダウンロードするための Model Context Protocol (MCP) サーバーです。このサーバーにより、MCP 互換クライアント（Claude Desktop など）は、YouTube や 1000 以上の対応サイトから動画をダウンロードし、音声を抽出し、字幕をダウンロードし、ライブストリームをキャプチャできます。

クレジット

このプロジェクトは、yt-dlp チームによる素晴らしい成果の上に構築されています。yt-dlp は、数千のサイトに対応する多機能なコマンドライン音声/動画ダウンローダーです。yt-dlp の詳細については、GitHub リポジトリ または wiki をご覧ください。

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 の再起動

設定を追加したら、新しい MCP サーバーを読み込むために Claude Desktop を再起動します。

使用方法

設定が完了すると、Claude に次のように依頼できます:

• "この YouTube 動画をダウンロードして: [URL]"

• "この動画から音声だけを MP3 としてダウンロードして"

• "この動画をダウンロードせずに情報を取得して"

• "この動画で利用可能なすべてのフォーマットを一覧表示して"

• "YouTube で [トピック] に関する動画を検索して"

• "この動画のスペイン語の字幕をダウンロードして"

利用可能なツール

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 アシスタントがツールを使用できるようにするプロトコル