yt-dlp-mcp

一个集成了 yt-dlp 的 MCP 服务器实现，为 LLM 提供视频和音频内容下载功能（例如，YouTube、Facebook、Tiktok 等）。

特性

• 字幕: 下载 SRT 格式的字幕，供 LLM 阅读
• 视频下载: 将视频保存到您的 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 中点击 "+ Add MCP Server"
2. 复制并粘贴以下配置：

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

3. 点击 "Save" 以安装 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 执行以下操作：

"List available subtitles for this video: https://youtube.com/watch?v=..."
"Download a video from facebook: https://facebook.com/..."
"Download Chinese subtitles from this video: https://youtube.com/watch?v=..."
"Download this video in 1080p: https://youtube.com/watch?v=..."
"Download audio from this YouTube video: https://youtube.com/watch?v=..."

手动启动

如果需要，手动启动服务器：

npx @kevinwatt/yt-dlp-mcp

要求

• Node.js 20+
• 系统 PATH 中包含 yt-dlp
• MCP 兼容的 LLM 服务

文档

• API 参考
• 配置
• 错误处理
• 贡献

许可证

MIT

作者

Dewei Yen