yt-dlp-mcp

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

功能

• 字幕：以SRT格式下载字幕供LLMs阅读
• 视频下载：将视频保存到您的下载文件夹，并可控制分辨率
• 音频下载：将音频保存到您的下载文件夹
• 注重隐私：直接下载，无追踪
• MCP集成：与Dive及其他兼容MCP的LLMs一起工作

安装

前提条件

根据您的操作系统安装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

  • 将视频下载到用户的下载文件夹
  • 输入：
    • url (字符串, 必填): 视频的URL
    • resolution (字符串, 可选): 视频分辨率('480p', '720p', '1080p', 'best')。默认为'720p'

• download_audio

  • 以最佳可用质量（通常是m4a/mp3格式）将音频下载到用户的下载文件夹
  • 输入：
    • 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