Yt Dlp Mcp

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"
]
}
}
}
  1. 点击 "保存" 安装 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 参考
  • 配置指南
  • 错误处理

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

  • 0 关注
  • 0 收藏,8 浏览
  • system 提出于 2025-09-28 01:09

相似服务问题