项目简介
yt-dlp-mcp 是一个基于 Model Context Protocol (MCP) 构建的服务器,它集成 yt-dlp 工具,为大型语言模型 (LLM) 提供音视频内容下载功能。通过 yt-dlp-mcp,LLM 可以轻松获取来自 YouTube、Facebook、TikTok 等平台的视频、音频和字幕内容,从而扩展 LLM 的信息获取和处理能力。
主要功能点
- 字幕下载: 支持下载视频字幕,包括自动生成的字幕,并提供多种字幕格式(如 SRT)。
- 视频下载: 允许 LLM 指示服务器下载指定分辨率的视频文件到用户本地的 Downloads 文件夹。
- 音频下载: 允许 LLM 指示服务器下载视频的音频文件,并保存到用户本地 Downloads 文件夹。
- 隐私保护: 所有下载操作均为直连下载,不涉及用户追踪。
- MCP 兼容性: 完美兼容 Dive Desktop 等 MCP 客户端。
安装步骤
-
安装 yt-dlp: 根据您的操作系统,安装 'yt-dlp' 命令行工具。
# Windows winget install yt-dlp # macOS brew install yt-dlp # Linux pip install yt-dlp -
集成到 MCP 客户端 (以 Dive Desktop 为例): 如果您使用 Dive Desktop 等 MCP 客户端,可以通过以下步骤快速添加 yt-dlp-mcp 服务器:
- 打开 Dive Desktop,点击 "+ Add MCP Server"。
- 复制并粘贴以下 JSON 配置信息。
- 点击 "Save" 保存配置。
服务器配置
以下是配置 yt-dlp-mcp 服务器的 JSON 信息,通常用于 MCP 客户端配置,例如 Dive Desktop。
{ "mcpServers": { "yt-dlp": { // 服务器名称,可自定义 "command": "npx", // 启动服务器的命令,这里使用 npx 执行 npm 包 "args": [ // 启动参数 "-y", // npx 的参数,-y 表示自动确认执行 "@kevinwatt/yt-dlp-mcp" // yt-dlp-mcp 的 npm 包名,npx 会自动下载并执行 ] } } }
配置说明:
- '"yt-dlp"': 服务器名称,您可以自定义,用于在 MCP 客户端中标识该服务器。
- '"command": "npx"': 指定用于启动服务器的命令为 'npx'。'npx' 是 Node.js 的包执行器,可以方便地运行 npm 包。
- '"args": [...]': 启动参数数组。
- '"-y"': 传递给 'npx' 的参数,'-y' 或 '--yes' 选项表示自动确认执行 npm 包,避免在启动时出现交互式提示。
- '"@kevinwatt/yt-dlp-mcp"': 指定要通过 'npx' 执行的 npm 包名称为 '@kevinwatt/yt-dlp-mcp'。'npx' 会自动查找、下载(如果尚未安装)并执行该 npm 包,从而启动 yt-dlp-mcp 服务器。
基本使用方法
配置完成后,在您的 LLM 应用中,您可以向 LLM 发出指令,指示其使用 yt-dlp-mcp 服务器的功能。以下是一些使用示例:
"列出这个视频的所有可用字幕: 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=..."
LLM 会解析您的指令,并调用 yt-dlp-mcp 服务器提供的工具来执行相应的操作。下载的文件将保存在您用户目录下的 "Downloads" 文件夹中。
信息
分类
网页与API