🚀 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 参考
• 配置指南
• 错误处理

此项目为您提供了一个强大且灵活的工具，用于将视频和音频内容整合到您的大语言模型工作流程中。