Youtube MCP Download

MCP音视频

提供方 granludo

音视频 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个基于Python的工具集,用于下载YouTube视频和播放列表,支持简单的脚本下载和高级的MCP服务器管理。

一句话选型结论

按资料字段整理

Youtube MCP Download 属于音视频类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

视频下载Python本地部署YouTube工具Python脚本MCP服务器异步下载

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python3 youtube_downloader.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Youtube MCP Download当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方granludo上游标注的维护方 granludo
分类音视频本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.7 KB
来自项目仓库与上游目录的原文,未做删改

YouTube视频下载器

使用yt-dlp下载YouTube内容的Python工具的综合集合,包括简单的脚本和高级MCP服务器。

工具

1.简单脚本

单视频下载器(youtube_downloader.py)

下载带有进度跟踪的单个YouTube视频。

播放列表下载器(playlist_downloader.py)

有序下载整个YouTube播放列表。

2.MCP服务器(youtube_mcp_server_fastmcp.py)

使用FastMCP的高级MCP(模型上下文协议)服务器,提供:

  • 异步视频和播放列表下载
  • 作业跟踪和状态监控
  • 用于元数据存储的SQLite数据库
  • 图书馆综合管理
  • Claude桌面集成

特性

简单脚本

单视频下载器

  • ✅ 提示用户输入YouTube URL
  • ✅ 下载最优质的视频
  • ✅ 创建一个 downloads 保存视频的文件夹
  • ✅ 显示下载进度
  • ✅ 优雅地处理错误
  • ✅ 如果yt-dlp不存在,则自动安装yt-dlp
  • ✅ 无pytube依赖性(根据要求)

播放列表下载器

  • ✅ 提示用户输入YouTube播放列表URL
  • ✅ 下载整个播放列表(默认情况下最多50个视频)
  • ✅ 为每个播放列表创建有组织的文件夹
  • ✅ 下载前显示播放列表信息
  • ✅ 下载带有播放列表索引号的视频
  • ✅ 如果yt-dlp不存在,则自动安装yt-dlp
  • ✅ 下载大型播放列表前的确认提示

MCP服务器功能

  • ✅ 异步下载:开始下载并获取用于跟踪的作业ID
  • ✅ 作业状态监控:检查下载进度和状态
  • ✅ 元数据库:带有视频/播放列表信息的SQLite数据库
  • ✅ 图书馆管理:浏览所有下载的内容
  • ✅ 错误处理:全面的错误跟踪和报告
  • ✅ 并发下载:可以同时运行多个下载
  • ✅ 元数据:存储标题、描述、持续时间、文件路径等。

需求

  • Python 3.11+
  • yt-dlp(丢失时自动安装)
  • MCP SDK(丢失时自动安装)

用法

单视频下载

  1. 运行单个视频下载程序:```bash
    python3 youtube_downloader.py

1. 出现提示时输入YouTube URL

1. 视频将下载到 `downloads` 文件夹

### 播放列表下载

1. 运行播放列表下载程序:```bash
python3 playlist_downloader.py
  1. 出现提示时输入YouTube播放列表URL

  2. 查看播放列表信息并确认下载

  3. 所有视频都将下载到特定于播放列表的文件夹中

MCP服务器使用情况

MCP服务器为异步下载和库管理提供了四种主要工具。

与紫外线一起使用(推荐)

  1. 安装依赖项并运行:```bash
    cd /Users/granludo/code/testing/youtube_download
    uv sync
    uv run python start_server.py

#### 直接使用Python```bash
python3 youtube_mcp_server_fastmcp.py

可用的MCP工具

  1. 下载_视频 -开始异步视频下载
  2. 下载播放列表 -开始异步播放列表下载
  3. get_download_status -监控下载进度
  4. cancel_下载 -取消正在运行的下载
  5. list_downloads -浏览所有下载作业
  6. 获取_视频_元数据 -无需下载即可获取视频信息

例子

单个视频示例```bash

$ python3 youtube_downloader.py

==================================================
YouTube Video Downloader
==================================================
Enter YouTube URL: https://www.youtube.com/watch?v=dQw4w9WgXcQ
📥 Downloading video from: https://www.youtube.com/watch?v=dQw4w9WgXcQ
✓ Download completed!
📁 Files saved to: /path/to/downloads


### 播放列表示例```bash
$ python3 playlist_downloader.py

==================================================
YouTube Playlist Downloader
==================================================
Enter YouTube Playlist URL: https://www.youtube.com/playlist?list=PLrAXtmRdnEQy5rhxJj7aKre_2qO5yQ5nI
📊 Analyzing playlist...
📋 Playlist name: My Music Playlist
🎥 Number of videos: 25

🔄 Download 25 videos? (y/N): y
📥 Downloading playlist: My Music Playlist
✓ Playlist download completed!
📁 All videos saved to: /path/to/playlists/My Music Playlist

MCP服务器示例

使用紫外线

  1. 安装并运行服务器:```bash
    cd /Users/granludo/code/testing/youtube_download
    uv sync # Install dependencies
    uv run python start_server.py # Start server

1. **服务器将静默启动** (根据MCP协议的要求,没有stdout输出)

#### MCP工具示例

**工具1:下载单个视频**```json
{
"name": "download_video",
"arguments": {
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"output_dir": "downloads"
}
}

答复: "Download started successfully. Job ID: abc123-def456-ghi789"

工具2:下载播放列表```json
{
"name": "download_playlist",
"arguments": {
"url": "https://www.youtube.com/playlist?list=PLrAXtmRdnEQy5rhxJj7aKre_2qO5yQ5nI",
"output_dir": "playlists"
}
}


答复: `"Playlist download started successfully. Job ID: def456-ghi789-jkl012"`

**工具3:检查下载状态**```json
{
"name": "get_download_status",
"arguments": {
"job_id": "abc123-def456-ghi789"
}
}

响应:包含作业状态、进度和元数据的JSON对象

工具4:列表下载```json
{
"name": "list_downloads",
"arguments": {}
}


答复:```
📹 VIDEOS:
- Never Gonna Give You Up (ID: video-uuid-123)
Path: /downloads/Never Gonna Give You Up.mp4
Duration: 213s

📁 PLAYLISTS:
- Music Collection (ID: playlist-uuid-456)
Videos: 25
Path: /playlists/Music Collection

完整工作流示例

  1. 配置Claude桌面 -将MCP服务器添加到您的 claude_desktop_config.json:```json
    {
    "mcpServers": {
    "youtube-mcp-tools": {
    "command": "/opt/homebrew/bin/uv",
    "args": [
    "--directory",
    "/Users/granludo/code/testing/youtube_download",
    "run",
    "start_server.py"
    ]
    }
    }
    }

1. **下载视频** 克劳德:```
"Download this YouTube video: https://www.youtube.com/watch?v=jNQXAC9IVRw"

服务器将启动下载并立即返回作业ID。

  1. 检查下载状态:```
    "What's the status of that download?"

1. **列出所有下载**:```
"Show me all my download jobs"

备注

简单脚本

  • 如果找不到yt-dlp,这两个脚本都会自动安装yt-dlp
  • 视频与原始标题一起保存
  • 播放列表视频按其在播放列表中的位置编号
  • 默认情况下,播放列表下载器将下载限制为50个视频(可调)
  • 这两个脚本都能优雅地处理键盘中断
  • 下载被组织在单独的文件夹中,分别用于视频和播放列表

MCP服务器

  • 使用FastMCP简化MCP服务器实施
  • 创建 youtube_library.db 用于元数据的SQLite数据库
  • 最多支持3次并发下载
  • 每次下载都使用唯一的UUID进行作业跟踪
  • 丰富的元数据存储,包括标题、描述、持续时间、文件路径
  • 异步下载,立即返回作业ID
  • 全面的错误处理和记录
  • 与Claude Desktop和其他MCP客户端兼容

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Youtube MCP Download 怎么安装?

在客户端按下面的安装命令接入:python3 youtube_downloader.py。装完在客户端配置里引用同一个包或端点。

Youtube MCP Download 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Youtube MCP Download 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Youtube MCP Download 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Youtube MCP Download 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Youtube MCP Download 能提供哪些能力?

资料显示能力标签包括 Python、Claude、语音音频。具体工具清单以官方文档为准。

Youtube MCP Download 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Youtube MCP Download 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。