Yt Dlp MCP (Kevinwatt)

MCP音视频

提供方 未标注

音视频 HTTP · 远程 未标注 社区 / 第三方
查看接入方式

全面解析Yt Dlp MCPMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器,Yt Dlp MCP能让AI助手访问实时数据、执行操作,为您提供更智能的工作体验和自动化解决方案。

一句话选型结论

按资料字段整理

Yt Dlp MCP (Kevinwatt) 属于音视频类 MCP 服务器,HTTP · 远程,鉴权方式未标注,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

安装与配置

HTTP · 远程 未标注
连远程 HTTPS 端点,通常为 Streamable HTTP
pip install yt-dlp

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

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

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

服务器档案

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

详细介绍

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

🎬 yt-dlp-mcp

A powerful MCP server that brings video platform capabilities to your AI agents

Integrate yt-dlp with Claude, Dive, and other MCP-compatible AI systems. Download videos, extract metadata, get transcripts, and more — all through natural language.


✨ Features

🔍 Search & Discovery

  • Search YouTube with pagination
  • JSON or Markdown output formats
  • Filter by relevance and quality

📊 Metadata Extraction

  • Comprehensive video information
  • Channel details and statistics
  • Upload dates, tags, categories
  • No content download required

📝 Transcript & Subtitles

  • Download subtitles in VTT format
  • Generate clean text transcripts
  • Auto-generated captions

🎥 Video Downloads

  • Resolution control (480p-1080p)
  • Video trimming support
  • Platform-agnostic (YouTube, Facebook, etc.)
  • Saved to Downloads folder

🎵 Audio Extraction

  • Best quality audio (M4A/MP3)
  • Direct audio-only downloads
  • Perfect for podcasts & music

🛡️ Privacy & Safety

  • No tracking or analytics
  • Direct downloads via yt-dlp
  • Zod schema validation
  • Character limits for LLM safety

🚀 Installation

Prerequisites

Install yt-dlp on your system:

Platform
Command

🪟 Windows
winget install yt-dlp

🍎 macOS
brew install yt-dlp

🐧 Linux
pip install yt-dlp

Getting Started

Add the following config to your MCP client:```json
{
"mcpServers": {
"yt-dlp": {
"command": "npx",
"args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"]
}
}
}


### MCP Client Configuration

Dive

1. Open Dive Desktop
2. Click **"+ Add MCP Server"**
3. Paste the config provided above
4. Click **"Save"** and you're ready!

Claude Code

Use the Claude Code CLI to add the yt-dlp MCP server (guide):```bash
claude mcp add yt-dlp npx @kevinwatt/yt-dlp-mcp@latest

Claude Desktop

Add to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: `~/.config/Claude/claude_desktop_config.json````json
    {
    "mcpServers": {
    "yt-dlp": {
    "command": "npx",
    "args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"]
    }
    }
    }

Cursor

Go to `Cursor Settings` -> `MCP` -> `New MCP Server`. Use the config provided above.

VS Code / Copilot

Install via the VS Code CLI:```bash
code --add-mcp '{"name":"yt-dlp","command":"npx","args":["-y","@kevinwatt/yt-dlp-mcp@latest"]}'

Or follow the MCP install guide with the standard config from above.

Windsurf

Follow the configure MCP guide using the standard config from above.

Cline

Follow Cline MCP configuration guide and use the config provided above.

Warp

Go to Settings · AI · Manage MCP Servers -> + Add to add an MCP Server. Use the config provided above.

JetBrains AI Assistant

Go to Settings · Tools · AI Assistant · Model Context Protocol (MCP) -> Add. Use the config provided above.

Manual Installation```bash

npm install -g @kevinwatt/yt-dlp-mcp


---

## 🛠️ Available Tools

All tools are prefixed with `ytdlp_` to avoid naming conflicts with other MCP servers.

### 🔍 Search & Discovery

Tool
Description

ytdlp_search_videos

Search YouTube with pagination and date filtering support
- **Parameters**: `query`, `maxResults`, `offset`, `response_format`, `uploadDateFilter`
- **Date Filter**: `hour`, `today`, `week`, `month`, `year` (optional)
- **Returns**: Video list with titles, channels, durations, URLs
- **Supports**: JSON and Markdown formats

### 📝 Subtitles & Transcripts

Tool
Description

ytdlp_list_subtitle_languages

List all available subtitle languages for a video
- **Parameters**: `url`
- **Returns**: Available languages, formats, auto-generated status

ytdlp_download_video_subtitles

Download subtitles in VTT format with timestamps
- **Parameters**: `url`, `language` (optional)
- **Returns**: Raw VTT subtitle content

ytdlp_download_transcript

Generate clean plain text transcript
- **Parameters**: `url`, `language` (optional)
- **Returns**: Cleaned text without timestamps or formatting

### 🎥 Video & Audio Downloads

Tool
Description

ytdlp_download_video

Download video to Downloads folder
- **Parameters**: `url`, `resolution`, `startTime`, `endTime`
- **Resolutions**: 480p, 720p, 1080p, best
- **Supports**: Video trimming

ytdlp_download_audio

Extract and download audio only
- **Parameters**: `url`
- **Format**: Best quality M4A/MP3

### 📊 Metadata

Tool
Description

ytdlp_get_video_metadata

Extract comprehensive video metadata in JSON
- **Parameters**: `url`, `fields` (optional array)
- **Returns**: Complete metadata or filtered fields
- **Includes**: Views, likes, upload date, tags, formats, etc.

ytdlp_get_video_metadata_summary

Get human-readable metadata summary
- **Parameters**: `url`
- **Returns**: Formatted text with key information

### 💬 Comments

Tool
Description

ytdlp_get_video_comments

Extract comments in flat JSON, threaded JSON, or AI-friendly Markdown
- **Parameters**: `url`, `maxComments`, `sortOrder`, `view`, `responseFormat`, `maxParents`, `maxReplies`, `maxRepliesPerThread`, `maxDepth`
- **Views**: `flat` (default) or `threaded`
- **Formats**: `json` (default) or `markdown_tree` (`markdown_tree` requires threaded view)
- **Returns**: Comment objects with `depth`, `reply_count`, `root_threads`, `reply_comments`, `orphan_comments`
- **Graceful Degradation**: On platforms without parent metadata, threaded mode falls back to root-only comments

ytdlp_get_video_comments_summary

Get a human-readable summary of comments
- **Parameters**: `url`, `maxComments`, `view`
- **Views**: `flat` (linear summary) or `threaded` (grouped reply trees)
- **Returns**: Readable comment digest with author badges, time, likes, and grouped replies

---

## 💡 Usage Examples

### Search Videos```
"Search for Python programming tutorials"
"Find the top 20 machine learning videos"
"Search for 'react hooks tutorial' and show results 10-20"
"Search for JavaScript courses in JSON format"

Get Metadata```

"Get metadata for https://youtube.com/watch?v=..."
"Show me the title, channel, and view count for this video"
"Extract just the duration and upload date"
"Give me a quick summary of this video's info"


### Get Comments```
"Get the top 20 comments for https://youtube.com/watch?v=..."
"Get comments as threaded JSON for this video"
"Extract comments as markdown_tree so the reply branches stay intact"
"Get newest comments with maxDepth 1 and maxRepliesPerThread 0"
"Summarize comments in threaded view"

Download Subtitles & Transcripts```

"List available subtitles for https://youtube.com/watch?v=..."
"Download English subtitles from this video"
"Get a clean transcript of this video in Spanish"
"Download Chinese (zh-Hant) transcript"


### Download Content```
"Download this video in 1080p: https://youtube.com/watch?v=..."
"Download audio from this YouTube video"
"Download this video from 1:30 to 2:45"
"Save this Facebook video to my Downloads"

📖 Documentation

  • API Reference - Detailed tool documentation
  • Configuration - Environment variables and settings
  • Cookie Configuration - Authentication and private video access
  • Error Handling - Common errors and solutions
  • Contributing - How to contribute

🔧 Configuration

Environment Variables```bash

Downloads directory (default: ~/Downloads)

YTDLP_DOWNLOADS_DIR=/path/to/downloads

Default resolution (default: 720p)

YTDLP_DEFAULT_RESOLUTION=1080p

Default subtitle language (default: en)

YTDLP_DEFAULT_SUBTITLE_LANG=en

Allow URLs that resolve to localhost/private/link-local addresses (default: false)

YTDLP_ALLOW_PRIVATE_URLS=false


Only `http`/`https` URLs are accepted, and URLs whose host resolves to a loopback, private, or link-local address (e.g. `localhost`, `192.168.x.x`, `169.254.169.254`) are rejected. Set `YTDLP_ALLOW_PRIVATE_URLS=true` if you need to fetch media from your local network.

> **Limitation:** this check runs once on the URL you pass in, before yt-dlp starts. yt-dlp then makes its own connections, so it does **not** cover HTTP redirects to internal addresses or DNS rebinding. If you run this server where reaching internal services matters (e.g. a shared or cloud-hosted deployment), restrict outbound traffic at the network layer (container network policy, firewall, or blocking `169.254.169.254`).

See the Configuration Guide for the full list.

### Proxy and yt-dlp Config File

All tools read your yt-dlp config file (`~/.config/yt-dlp/config`), so any
`--proxy`, `--cookies` or other options set there apply automatically. This is
the only channel available to MCP clients that cannot pass environment
variables to the server process.

These are alternatives — set only the one you need:

| Setting | Effect |
|---------|--------|
| `YTDLP_PROXY=socks5://127.0.0.1:1080` | Route all requests through this proxy |
| `YTDLP_PROXY=` (empty) | Force a direct connection, overriding a proxy in the yt-dlp config file |
| `YTDLP_IGNORE_CONFIG=1` | Skip all yt-dlp config files |

Supported proxy schemes: `http`, `https`, `socks4`, `socks5`, `socks5h`.

> `YTDLP_IGNORE_CONFIG=1` is not a straight revert to 0.9.x. The search,
> metadata and comments tools always read the config file, so this setting
> stops them from doing so as well.

**MCP Configuration with a proxy:**```json
{
  "mcpServers": {
    "yt-dlp": {
      "command": "npx",
      "args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"],
      "env": {
        "YTDLP_PROXY": "socks5://127.0.0.1:1080"
      }
    }
  }
}

If your MCP client cannot pass environment variables to the server, put the
options in ~/.config/yt-dlp/config instead — every tool reads that file:```
--proxy socks5://127.0.0.1:1080
--cookies /path/to/cookies.txt


> **Note**: Your config file applies to downloads as well. Options that change
> the output format (`-x`, `--remux-video`, `--recode-video`) change what the
> download tools produce; the tools report the file yt-dlp actually wrote, so
> the reported name stays correct. Output-location options (`-o`, `-P`) have no
> effect, because the tools always pass an absolute `--output` on the command
> line, which takes precedence.
>
> **Note**: yt-dlp config files can contain options that execute commands
> (`--exec`, `--postprocessor-args`, `--ffmpeg-location`). These now run on
> tool invocations too, including ones triggered by an AI assistant. Set
> `YTDLP_IGNORE_CONFIG=1` if you would rather the server ignore your config
> file entirely.

### Cookie Configuration

To access private videos, age-restricted content, or avoid rate limits, configure cookies:

> ⚠️ **Important**: Cookie authentication requires a JavaScript runtime (deno) to be installed. When using cookies, YouTube uses authenticated API endpoints that require JavaScript challenge solving. Without deno, downloads will fail with "n challenge solving failed" error.
>
> Install deno: https://docs.deno.com/runtime/getting_started/installation/```bash
# Extract cookies from browser (recommended)
YTDLP_COOKIES_FROM_BROWSER=chrome

# Or use a cookie file
YTDLP_COOKIES_FILE=/path/to/cookies.txt

MCP Configuration with cookies:```json
{
"mcpServers": {
"yt-dlp": {
"command": "npx",
"args": ["-y", "@kevinwatt/yt-dlp-mcp@latest"],
"env": {
"YTDLP_COOKIES_FROM_BROWSER": "chrome"
}
}
}
}


Supported browsers: `brave`, `chrome`, `chromium`, `edge`, `firefox`, `opera`, `safari`, `vivaldi`, `whale`

See Cookie Configuration Guide for detailed setup instructions.

---

## 🏗️ Architecture

### Built With

- **yt-dlp** - Video extraction engine
- **MCP SDK** - Model Context Protocol
- **Zod** - TypeScript-first schema validation
- **TypeScript** - Type safety and developer experience

### Key Features

- ✅ **Type-Safe**: Full TypeScript with strict mode
- ✅ **Validated Inputs**: Zod schemas for runtime validation
- ✅ **Character Limits**: Automatic truncation to prevent context overflow
- ✅ **Tool Annotations**: readOnly, destructive, idempotent hints
- ✅ **Error Guidance**: Actionable error messages for LLMs
- ✅ **Modular Design**: Clean separation of concerns

---

## 📊 Response Formats

### JSON Format
Perfect for programmatic processing:```json
{
  "total": 50,
  "count": 10,
  "offset": 0,
  "videos": [...],
  "has_more": true,
  "next_offset": 10
}

Markdown Format

Human-readable display:```markdown
Found 50 videos (showing 10):

  1. Video Title
    📺 Channel: Creator Name
    ⏱️ Duration: 10:30
    🔗 URL: https://...

### Comment Markdown Tree
Useful for LLM analysis when reply context matters:```markdown
# AI-Ready Comment Threads

source_title: "Sample Video"
comments_detected: 20
root_threads: 6
reply_comments: 14

## Threads

### Thread 1

- comment_id: "abc123"
  parent_id: "root"
  depth: 0
  reply_count: 2
  text:
    | Root comment text
  - comment_id: "reply456"
    parent_id: "abc123"
    depth: 1
    reply_count: 0
    text:
      | Reply text

Comment Limits

YouTube comment extraction supports the full extractor tuple:text youtube:comment_sort=<sort>;max_comments=<total>,<parents>,<replies>,<repliesPerThread>,<depth>

Examples:
- Default behavior: maxComments=20 yields max_comments=20,20,20,20,2
- Root-only comments: maxDepth=1, maxRepliesPerThread=0
- Limited branching: maxReplies=40, maxRepliesPerThread=5, maxDepth=2


🔒 Privacy & Security

  • No Tracking: Direct downloads, no analytics
  • Input Validation: Zod schemas prevent injection
  • URL Validation: Strict URL format checking
  • Character Limits: Prevents context overflow attacks
  • Read-Only by Default: Most tools don't modify system state

🤝 Contributing

Contributions are welcome! Please check out our Contributing Guide.

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.


🙏 Acknowledgments

  • yt-dlp - The amazing video extraction tool
  • Anthropic - For the Model Context Protocol
  • Dive - MCP-compatible AI platform

📚 Related Projects

  • MCP Servers - Official MCP server implementations
  • yt-dlp - Command-line video downloader
  • Dive Desktop - AI agent platform

⬆ Back to Top

常见问题

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

在客户端按下面的安装命令接入:pip install yt-dlp。装完在客户端配置里引用同一个包或端点。

Yt Dlp MCP (Kevinwatt) 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Yt Dlp MCP (Kevinwatt) 收费吗?

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

Yt Dlp MCP (Kevinwatt) 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

Yt Dlp MCP (Kevinwatt) 能提供哪些能力?

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

Yt Dlp MCP (Kevinwatt) 需要什么运行环境?

运行时为 Python;属于远程端点,不需要在本地装运行时。

Yt Dlp MCP (Kevinwatt) 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

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

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