MCP Youtube Dlp

🚀 MCP YouTube-DLP サーバー

このサーバーは、yt-dlp を使用して YouTube の動画や音声をダウンロードするためのツールを提供する Model Context Protocol (MCP) サーバーです。

✨ 主な機能

• YouTube 動画を MP4 形式でダウンロード
• YouTube 音声を MP3 形式でダウンロード
• MCP と統合し、AI アシスタントとの連携をサポート

📦 インストール

前提条件

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

インストール手順

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

pip install -e .

または uv を使用する場合は、以下のコマンドを実行します。

uv pip install -e .

💻 使用例

サーバーの起動

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

python main.py

サーバーは標準入出力モードで動作し、デバッグ機能が有効になります。

環境変数

• 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

戻り値：

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

📚 ドキュメント

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

📄 ライセンス

このプロジェクトは GNU 一般公衆利用許諾契約書第 2 版（GPL-2.0）の下でライセンスされています。詳細については、GNU ウェブサイトを参照してください。