MCP yt-dlp 服务器

一个用于使用 yt-dlp 下载视频和流的模型上下文协议（MCP）服务器。该服务器使兼容 MCP 的客户端（如 Claude Desktop）能够从 YouTube 和 1000+ 支持的网站下载视频、提取音频、下载字幕以及捕获直播流。

致谢

本项目基于 yt-dlp 团队的杰出工作构建。yt-dlp 是一个功能丰富的命令行音视频下载器，支持数千个网站。有关 yt-dlp 的更多信息，请访问其 GitHub 仓库 或 wiki。

Related MCP server: MCP YouTube Downloader

功能

• 视频下载：从 YouTube 和 1000+ 支持的网站下载视频

• 流下载：捕获直播流和 HLS/m3u8 流

• 视频信息：无需下载即可获取元数据

• 格式列表：列出视频的所有可用格式

• 搜索：通过 yt-dlp 提取器直接搜索视频

• 音频提取：仅下载音频并进行格式转换（MP3、M4A、WAV、FLAC）

• 字幕：下载多种语言的字幕

• 播放列表支持：下载完整或部分播放列表

先决条件

• Node.js 18+

• yt-dlp 已安装，并且与服务器位于同一目录（或位于 PATH 中）

安装指南

步骤 1：安装 Node.js

从 nodejs.org 下载并安装 Node.js 18+。

验证安装：

node --version
npm --version

步骤 2：下载 yt-dlp（简易方法）

我们提供了设置脚本，可自动将最新的 yt-dlp 下载到正确的目录。

Windows： 双击 setup.bat 或在命令提示符中运行：

setup.bat

Linux / macOS：

chmod +x setup.sh
./setup.sh

该脚本将：

• 检测您的操作系统

• 下载最新的 yt-dlp 二进制文件

• 将其放置在与 MCP 服务器相同的目录中

• 验证安装

步骤 2 备选：手动下载

如果您希望手动安装 yt-dlp：

Windows：

1. 从 最新版本 下载 yt-dlp.exe

2. 将 yt-dlp.exe 放置在与 MCP 服务器相同的目录中

macOS：

curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod a+rx /usr/local/bin/yt-dlp

Linux：

sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

Python（所有平台）：

pip install yt-dlp

有关更多安装选项，请参阅 yt-dlp 安装指南。

步骤 3：克隆仓库

git clone https://github.com/timyee22/yt-dlp-MCP.git
cd yt-dlp-MCP

步骤 4：安装依赖

npm install

步骤 5：配置 MCP 客户端

将服务器添加到您的 MCP 客户端配置中：

Claude Desktop（Windows）： 编辑 %APPDATA%\Claude\settings.json：

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["C:\\path\\to\\yt-dlp-MCP\\index.js"]
    }
  }
}

Claude Desktop（macOS/Linux）： 编辑 ~/Library/Application Support/Claude/settings.json（macOS）或相应的配置路径：

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["/path/to/yt-dlp-MCP/index.js"]
    }
  }
}

重要： 确保 yt-dlp.exe（Windows）或 yt-dlp（macOS/Linux）满足以下任一条件：

• 与 index.js 位于同一目录

• 或位于系统 PATH 中

步骤 6：重启 Claude Desktop

添加配置后，重启 Claude Desktop 以加载新的 MCP 服务器。

使用方法

配置完成后，您可以要求 Claude：

• “下载这个 YouTube 视频：[URL]”

• “仅将此视频的音频下载为 MP3”

• “获取此视频的信息，无需下载”

• “列出此视频的所有可用格式”

• “在 YouTube 上搜索关于 [主题] 的视频”

• “下载此视频的西班牙语字幕”

可用工具

download_video

从 URL 下载视频。

参数：

• url（必需）：视频 URL

• outputDir：输出目录（默认：当前目录）

• format：格式选择（默认：“best”）

• quality：视频质量（例如，“1080p”、“720p”）

• audioOnly：仅下载音频（默认：false）

• audioFormat：提取的音频格式（默认：“mp3”）

• subtitles：下载字幕（默认：false）

• subtitleLangs：字幕语言（默认：“en”）

• playlistStart/playlistEnd：播放列表范围

• noPlaylist：仅下载单个视频（默认：false）

• additionalArgs：额外的 yt-dlp 参数

示例：

下载 YouTube 视频：

{
  "url": "https://www.youtube.com/watch?v=...",
  "quality": "1080p",
  "subtitles": true
}

仅下载音频：

{
  "url": "https://www.youtube.com/watch?v=...",
  "audioOnly": true,
  "audioFormat": "mp3"
}

download_stream

下载直播流或 HLS 流。

参数：

• url（必需）：流 URL

• outputDir：输出目录

• duration：捕获时长（秒）

• format：格式偏好（默认：“best”）

• outputName：自定义输出文件名

• hlsUseMpegts：对 HLS 使用 MPEG-TS（默认：true）

• additionalArgs：额外参数

get_video_info

获取视频元数据，无需下载。

参数：

• url（必需）：视频 URL

• flatPlaylist：更快的播放列表信息（默认：false）

list_formats

列出 URL 的所有可用格式。

参数：

• url（必需）：视频 URL

search_videos

使用 yt-dlp 提取器搜索视频。

参数：

• query（必需）：搜索查询

• extractor：搜索提取器前缀（默认：“ytsearch10”）

• getInfo：获取详细信息（默认：true）

示例：

{
  "query": "programming tutorials",
  "extractor": "ytsearch5"
}

update_yt_dlp

将 yt-dlp 更新到最新版本。

支持的网站

yt-dlp 支持 1000+ 个网站，包括：

• YouTube

• Twitch

• Vimeo

• Twitter/X

• Instagram

• TikTok

• Facebook

• SoundCloud

• 以及更多……

有关完整列表，请参阅 yt-dlp 支持的网站。

故障排除

找不到 yt-dlp

• 确保 yt-dlp.exe（Windows）或 yt-dlp（macOS/Linux）与服务器位于同一目录或位于 PATH 中

• 在 Windows 上，您可能需要将目录添加到 PATH 环境变量中

Node.js 错误

• 确保已安装 Node.js 18+：node --version

• 确保已安装依赖：npm install

格式不可用

• 某些视频可能没有请求的格式。使用 list_formats 查看可用选项

• YouTube 可能限制某些格式。尝试不同的质量设置

许可证

Unlicense

致谢

• yt-dlp - 使这一切成为可能的强大视频下载器

• 模型上下文协议 - 使 AI 助手能够使用工具