MCP YouTube-DLP

MCP YouTube-DLP

yt-dlp を使用して YouTube の動画と音声をダウンロードするツールを提供する、Model Context Protocol（MCP）サーバーです。

特長

• YouTube の動画を MP4 形式でダウンロード
• YouTube の音声を MP3 形式でダウンロード
• AI アシスタントとの連携に向けた MCP との統合

前提条件

• Python 3.13 以降
• システムに yt-dlp がインストールされていること

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします。

pip install -e .

または、uv を使用します。

uv pip install -e .

使用方法

サーバーの起動

MCP サーバーを起動します。

python main.py

サーバーはデバッグを有効にした stdio モードで起動します。

環境変数

• YT_DLP_PATH：yt-dlp 実行ファイルへのパス（デフォルト：/usr/local/bin/yt-dlp）
• DEFAULT_DOWNLOAD_DIR：動画のダウンロード先ディレクトリ（デフォルト：~/Downloads/youtube_downloads）

MCP の設定

この設定を MCP のセットアップに追加します。

{
  "mcpServers": {
    "mcp_youtube_dlp": {
      "command": "uvx",
      "args": [
        "mcp[cli]",
        "run",
        "<install path>/mcp_youtube_dlp/main.py"
      ],
      "env": {
        "YT_DLP_PATH": "/usr/local/bin/yt-dlp",
        "DEFAULT_DOWNLOAD_DIR": "~/Downloads/youtube_downloads"
      }
    }
  }
}

<install path> を、このパッケージをインストールした実際のパスに置き換えてください。

利用可能なツール

download_youtube_video

YouTube の動画を MP4 形式でダウンロードします。

パラメーター：

• url：YouTube 動画の URL

戻り値：

• 成功またはエラーメッセージ

download_youtube_audio

YouTube 動画の音声を MP3 形式でダウンロードします。

パラメーター：

• url：YouTube 動画の URL

戻り値：

• 成功またはエラーメッセージ

MCP との統合

このサーバーは Model Context Protocol を実装しており、AI アシスタントが YouTube コンテンツをダウンロードするツールにアクセスできるようにします。このサーバーは、MCP 対応のあらゆるクライアントに接続できます。

ライセンス

このプロジェクトは GNU General Public License バージョン 2（GPL-2.0）の下でライセンスされています。詳細については、GNU のウェブサイトをご覧ください。