Yt Dlp MCP

🚀 yt-dlp-mcp 項目

這是一個集成了 yt-dlp 的 MCP 服務器實現，主要為大語言模型（LLMs）提供視頻和音頻內容的下載功能，支持的平臺包括 YouTube、Facebook、TikTok 等。

🚀 快速開始

此項目能讓大語言模型方便地獲取各類視頻和音頻資源，您可以按照以下步驟進行安裝和使用。

✨ 主要特性

• 字幕：可下載 SRT 格式的字幕，方便 LLMs 閱讀。
• 視頻下載：能將視頻保存到您的 Downloads 文件夾，還支持分辨率控制。
• 音頻下載：把音頻保存到您的 Downloads 文件夾。
• 隱私保護：直接下載，無追蹤。
• MCP 集成：可與 Dive 和其他 MCP 兼容的 LLM 一起使用。

📦 安裝指南

先決條件

根據您操作系統的不同，安裝 yt-dlp：

# Windows
winget install yt-dlp

# macOS
brew install yt-dlp

# Linux
pip install yt-dlp

使用 Dive Desktop 集成

1. 在 Dive Desktop 中點擊 "+ 添加 MCP 服務器"。
2. 複製並粘貼以下配置：

{
  "mcpServers": {
    "yt-dlp": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/yt-dlp-mcp"
      ]
    }
  }
}

3. 點擊 "保存" 安裝 MCP 服務器。

📚 詳細文檔

工具文檔

• list_subtitle_languages

  • 功能：列出視頻所有可用字幕語言及其格式（包括自動生成的字幕）。
  • 輸入參數：
    • url (字符串，必填)：視頻 URL。

• download_video_subtitles

  • 功能：下載指定語言的視頻字幕，支持自動生成和常規字幕。
  • 輸入參數：
    • url (字符串，必填)：視頻 URL。
    • language (字符串，可選)：語言代碼（例如 'en'、'zh-Hant'、'ja'）。默認為 'en'。

• download_video

  • 功能：將視頻下載到用戶的 Downloads 文件夾。
  • 輸入參數：
    • url (字符串，必填)：視頻 URL。
    • resolution (字符串，可選)：視頻分辨率 ('480p', '720p', '1080p', 'best')。默認為 '720p'。

• download_audio

  • 功能：下載最高質量的音頻（通常為 m4a/mp3 格式）到用戶 Downloads 文件夾。
  • 輸入參數：
    • url (字符串，必填)：視頻 URL。

💻 使用示例

基礎用法

讓您的 LLM 執行以下操作：

"列出此視頻的所有字幕語言：https://youtube.com/watch?v=..."
"下載這個來自 Facebook 的視頻：https://facebook.com/..."
"下載該視頻的中文字幕：https://youtube.com/watch?v=..."
"以 1080p 分辨率下載該視頻：https://youtube.com/watch?v=..."
"下載這個 YouTube 視頻的音頻：https://youtube.com/watch?v=..."

手動啟動

如有需要，手動啟動服務器：

npx @kevinwatt/yt-dlp-mcp

🔧 技術細節

運行要求

• Node.js 版本 >= 14.0.0。
• yt-dlp 安裝在系統路徑中。
• 兼容的 LLM 服務。

文檔信息

如需更多信息，請參考：

• API 參考
• 配置指南
• 錯誤處理

此項目為您提供了一個強大且靈活的工具，用於將視頻和音頻內容整合到您的大語言模型工作流程中。