MCP Youtube Dlp

🚀 MCP YouTube-DLP 服務器

本項目是一個基於 Model Context Protocol (MCP) 的服務器，藉助 yt-dlp 工具，可實現 YouTube 視頻與音頻的下載功能，為用戶提供便捷的內容獲取途徑。

🚀 快速開始

本服務器以標準輸入輸出模式運行，並啟用調試功能，使用前需確保滿足先決條件，然後按安裝步驟操作，最後運行服務器即可開始使用。

✨ 主要特性

• 🎬 支持將 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 兼容的客戶端，通過與 MCP 的整合，為 AI 助手提供了便捷的 YouTube 內容下載功能。

📄 許可證

本項目根據 GNU 通用公共許可證第 2 版（GPL - 2.0）授權，詳情請參閱 GNU 網站。