Yt Dlp MCP Container

MCP音视频

提供方 memorysaver

音视频 未标注 会话登录 社区 / 第三方 Claude

yt-dlp MCP容器是一个生产就绪的服务,将yt-dlp(支持1000多个平台的强大视频下载器)作为可通过服务器发送事件(SSE)远程访问的模型上下文协议(MCP)服务器,适用于Claude AI集成和视频下载管理。

一句话选型结论

按资料字段整理

Yt Dlp MCP Container 属于音视频类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

视频下载Python本地部署AI集成容器化服务RESTAPISSE通信

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

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

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Yt Dlp MCP Container当前 未标注 未标注 未标注 无 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

服务器档案

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

详细介绍

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

yt-dlp MCP 容器

> 一个容器化的yt-dlp服务器,具备远程SSE基于的MCP集成以供Claude AI使用,并提供REST API用于工件管理

概述

yt-dlp MCP 容器 是一个可投入生产的就绪服务,用于暴露(或提供) yt-dlp(一个用于从YouTube等网站下载视频的命令行工具) (一款支持1000多个平台的强大视频下载器)作为 模型上下文协议(MCP)服务器 可通过远程方式访问 服务器发送事件(SSE). 用……建造 FastMCP 并且借助FastAPI,这项服务使得Claude AI能够从YouTube、Vimeo、Twitter以及众多其他平台下载并处理视频。

为何这很重要

  • 克劳德集成(或译为“克劳德整合”)克劳德可以通过自然对话直接下载并分析视频
  • 远程访问基于SSE的MCP终端使Claude能够从任何地方通过HTTPS进行连接
  • 双接口使用通过Claude或REST API的MCP工具进行直接访问
  • 准备就绪,可投入生产已容器化并针对Zeabur平台进行了优化部署

主要特点

1. 远程SSE MCP终端

  • 将 yt-dlp 的功能作为 MCP 工具提供,可通过 服务器发送事件
  • 克劳德进行远程连接 https://your-app.zeabur.app/sse
  • 通过持久HTTP连接实现的实时双向通信
  • 无需本地安装

2. FastMCP与FastAPI的集成

  • FastMCP 将 yt-dlp CLI 封装为类型安全的 MCP 工具
  • MCP服务器作为SSE端点安装在FastAPI中
  • 支持非阻塞下载的异步/等待(Async/await)功能
  • 干净、可维护的Python代码库

3. 艺术品管理REST API

  • 状态检查监控下载进度和完成情况
  • 工件下载检索已处理的视频/音频文件
  • 资源管理清理旧的下载文件
  • 健康监测服务健康检查

4. 广泛的平台支持

由 yt-dlp 提供支持,支持从以下来源下载:

  • YouTube,YouTube Music(优兔音乐)
  • Vimeo,Dailymotion(这两个都是视频分享网站)
  • Twitter/X、Facebook、Instagram
  • Twitch,TikTok
  • 1000多个更多平台

建筑学```

┌─────────────┐ SSE (HTTPS) ┌──────────────────┐
│ │────────────────────────────▶ │ FastAPI App │
│ Claude │ │ │
│ │◀────────────────────────────│ SSE Endpoint │
└─────────────┘ MCP Protocol │ (/sse) │
│ │
│ ┌──────────┐ │
│ │ FastMCP │ │
│ │ Server │ │
│ └────┬─────┘ │
┌─────────────┐ REST API │ │ │
│ User/ │────────────────────────────▶│ ▼ │
│ Browser │ │ yt-dlp CLI │
│ │◀────────────────────────────│ │
└─────────────┘ Status/Artifacts └────────┬─────────┘
│
▼
┌─────────────────┐
│ File Storage │
│ (Downloads) │
└─────────────────┘


### 它是如何运作的

1. **克劳德连接**克劳德作为远程MCP服务器连接到SSE终端
1. **工具调用**克劳德称之为MCP工具(例如。, `download_video`)
1. **处理**FastMCP 将呼叫路由到 yt-dlp 命令行界面,执行下载操作
1. **存储**下载的文件存储在指定目录中,每个文件都有唯一标识符
1. **状态与检索**通过REST API监控进度,准备好后下载工件

## 快速入门

### 第一步:安装

选择您的部署方法:

- **本地开发:** 本地安装指南
- **云部署:** Zeabur 安装指南

两种选项都需要通过Cookie认证才能访问YouTube。请参阅 Cookie 认证指南 用于设置说明。

### 步骤2:配置Claude

添加到您的Claude桌面配置中:

**macOS(苹果电脑操作系统)**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"yt-dlp": {
"type": "http",
"url": "http://localhost:8000/mcp/"
}
}
}

对于Zeabur部署,请替换为您的应用URL: https://your-app.zeabur.app/mcp/

重启Claude桌面版 并且 yt-dlp 工具将可用!

步骤3:开始使用

开启一段新对话并尝试:```
Download video from https://www.youtube.com/watch?v=dQw4w9WgXcQ


**如需完整的设置说明,请参阅 安装指南.md**

## MCP 工具

连接后,克劳德可以访问这些工具:

| 工具 | 用途 |
|------|---------|
| `download_video` | 下载单个视频(选择画质/分辨率) |
| `download_audio` | 仅提取音频(mp3/m4a/opus/wav/flac) |
| `download_playlist` | 从播放列表中下载一系列视频 |
| `download_subtitles` | 获取指定语言的字幕/字幕文本 |
| `download_thumbnail` | 下载最高质量的缩略图图像 |
| `get_video_info` | 获取视频元数据为JSON格式(标题、时长、格式等) |
| `list_formats` | 列出所有可用格式及其详细信息 |
| `get_download_status` | 检查任何下载的进度和状态 |

**要查看所有工具的详细文档、参数、示例和使用说明,请参阅 MCP工具使用说明.md**

## REST API

FastAPI 服务器还提供了 REST 端点以供直接访问:

### `GET /health`

健康检查端点。

**回复:**```json
{
"status": "healthy",
"service": "yt-dlp-mcp",
"version": "1.0.0"
}

GET /downloads

列出所有下载及其状态。

回答:```json
{
"downloads": [
{
"id": "7a8f9e2b",
"url": "https://youtube.com/watch?v=...",
"status": "completed",
"filename": "video.mp4",
"size": 15728640,
"created_at": "2025-01-13T10:30:00Z",
"completed_at": "2025-01-13T10:32:15Z"
}
]
}


### `GET /downloads/{download_id}`

获取特定下载的状态。

**回答:**```json
{
"id": "7a8f9e2b",
"status": "in_progress",
"progress": 45.2,
"eta": "00:01:30",
"speed": "2.5MB/s"
}

状态值:

  • pending已排队,尚未开始
  • in_progress正在下载中
  • completed准备下载
  • failed发生了错误

GET /artifacts/{download_id}

下载处理后的视频/音频文件。

回答: 带有适当Content-Type头部的二进制文件流

示例:```bash
curl -O https://your-app.zeabur.app/artifacts/7a8f9e2b


### `DELETE /downloads/{download_id}`

删除一个下载项及其相关文件。

**回答:**```json
{
"message": "Download and artifacts deleted successfully",
"id": "7a8f9e2b"
}

配置

使用环境变量配置服务:

变量 · 描述 · 默认值 · 是否必需
不 · PORT · 8000 · HTTP服务器端口
不 · DOWNLOAD_DIR · /app/downloads · 存储下载文件的目录
序号 · MAX_DOWNLOAD_SIZE_MB · 0 · 文件最大大小(以MB为单位)(0 = 无限制)
不是 · CLEANUP_INTERVAL_HOURS · 24 · 自动清理间隔(小时)
不 · MAX_CONCURRENT_DOWNLOADS · 3 · 最大同时下载数
不是 · LOG_LEVEL · INFO · 日志级别
不 · API_KEY
可选的API密钥用于身份验证 · 无 · 否 · CORS_ORIGINS · * · 允许的CORS来源(逗号分隔)

** · 不 · ** 注:

现在,启动时会自动使用无头模式的Chromium生成Cookies。无需手动导出Cookies! 有关详细配置和设置说明,请参阅

使用示例

  1. 典型工作流程 用户要求克劳德下载 download_video() → 克劳德使用
  2. MCP工具 获取下载ID
  3. → 用于追踪和检索 监控进度 get_download_status() → 使用
  4. MCP工具或REST API 下载工件(或:下载制品) /artifacts/{download_id}

使用REST API终端点

  • 这种混合方法结合了: MCP工具
  • 用于AI驱动的交互与自动化 REST API(Representational State Transfer Application Programming Interface,表述性状态传递应用程序编程接口)

用于直接文件访问和与其他工具的集成 如需查看包含真实工作流程的完整示例,请参阅

MCP工具使用指南.md

发展

本地设置```bash
git clone https://github.com/yourusername/yt-dlp-mcp-container.git
cd yt-dlp-mcp-container
cp .env.example .env # Copy environment template
docker-compose up -d # Start server with auto-generated cookies


**快速入门: 如需详细的设置说明,请参阅**

### 安装指南.md```
yt-dlp-mcp-container/
├── server.py              # FastAPI + FastMCP application
├── download_manager.py    # Download queue and status tracking
├── cookie_generator.py    # Headless Chromium cookie generator
├── entrypoint.sh          # Container startup script
├── requirements.txt       # Python dependencies
├── Dockerfile             # Container configuration
├── docker-compose.yml     # Local development setup
├── .env.example           # Environment template
├── README.md              # This file
├── INSTALLATION_GUIDE.md  # Complete installation guide
├── MCP_TOOLS_USAGE.md     # Tool documentation
└── downloads/             # Storage directory (created at runtime)

项目结构

贡献;助力

  1. 欢迎投稿!请:
  2. 为仓库创建分支副本git checkout -b feature/amazing-feature创建一个特性分支(
  3. )git commit -m 'Add amazing feature'提交您的更改(
  4. )git push origin feature/amazing-feature推送到分支(
  5. )

提交一个拉取请求

法律免责声明 ⚠️(警告或注意的符号,无具体文字含义)重要的

  • 此工具仅供教育和个人使用。
  • 只下载你有权下载的视频
  • 遵守版权法和平台服务条款
  • 注意并遵守当地关于内容下载的法律法规

此工具不应被用于侵犯知识产权

作者和贡献者不对该工具的使用方式负责。

故障排除

常见问题

  • MCP 工具不可用:
  • 配置更改后重启Claude桌面版
  • 开始新对话(MCP在对话开始时连接) curl http://localhost:8000/health

验证服务器健康状况:

  • YouTube机器人检测:
  • 确保cookie已正确配置
  • 如果过期,则重新出口新鲜饼干(注:此句在实际商业语境中可能略显生硬,更自然的表达可能是“如已过期,则提供新鲜饼干作为替换”或“如饼干过期,请更换为新鲜饼干”) 见

Cookie认证指南

  • 下载失败:
  • 检查日志中的 yt-dlp 错误信息
  • 验证视频URL是否有效且可访问

确保有足够的磁盘空间 如需进行全面的故障排除,请参阅

许可证 这个项目遵循MIT许可证授权——详见 许可证

文件中有详细信息。

版权所有 (c) 2025 Ho Ming-Cheng

致谢与鸣谢

  • 这个项目是基于优秀的开源工具构建的: yt-dlp(可直接译为“YouTube下载器”或根据具体语境译为“视频下载工具”等)
  • - 强大的视频下载器 FastMCP
  • - 用于构建MCP服务器的Python框架 FastAPI
  • - 用于构建API的现代网络框架 模型上下文协议
  • - 人工智能工具集成协议 克劳德

- 人类中心主义公司的AI助手

  • 支持问题 :
  • GitHub Issues(在GitHub上报告的问题)讨论 :
  • GitHub 讨论区文档 :

维基

为Claude和MCP社区用心打造

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Yt Dlp MCP Container 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Yt Dlp MCP Container 收费吗?

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

Yt Dlp MCP Container 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Yt Dlp MCP Container 支持哪些客户端?

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

Yt Dlp MCP Container 能提供哪些能力?

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

热门专题

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

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