🎬 opc-youtube-dl-mcp

MCP Server wrapping yt-dlp (180K+ stars) — video/audio download and metadata extraction for AI agents

Overview

opc-youtube-dl-mcp wraps the powerful yt-dlp CLI tool as an MCP server, enabling AI agents to fetch video metadata, list formats, and download media.

Tools

| Tool | Description | |------|-------------| | get_info | Extract video/playlist metadata (title, duration, uploader, views, etc.) | | get_formats | List all available download formats with resolutions, codecs, and sizes | | download_video | Download video or audio with format selection |

Prerequisites

# macOS
brew install yt-dlp

# Linux
pip install yt-dlp

# Or download the standalone binary
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod +x /usr/local/bin/yt-dlp

Installation

npm install opc-youtube-dl-mcp

Usage

As an MCP server

{
  "mcpServers": {
    "youtube-dl": {
      "command": "npx",
      "args": ["opc-youtube-dl-mcp"]
    }
  }
}

Example: get_info

Input:  { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
Output: { title, duration, uploader, view_count, thumbnail, description }

Example: get_formats

Input:  { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "filter": "video" }
Output: Table of format IDs, resolutions, codecs, and file sizes

Example: download_video

Input:  { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "format": "best", "audio_only": false }
Output: Downloaded: ./downloads/Rick Astley - Never Gonna Give You Up.mp4

Features

• Metadata extraction — Title, duration, upload date, view count, description
• Format listing — All available video/audio formats with codec details
• Video download — Download with format selection (best, 720p, audio-only, etc.)
• Playlist support — Works with YouTube playlists, channels, and other platforms
• Multi-platform — Supports YouTube, Bilibili, Vimeo, and 1000+ other sites

License

MIT