Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Video Downloader Download the audio from this YouTube video"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server for downloading videos and audio from various platforms using yt-dlp.
Video and audio downloads with configurable quality
Progress tracking via SQLite database
Worker-based architecture with child process isolation
Security-first design with URL validation and SSRF protection
Batch download support
Cancellation and retry mechanisms
Automatic cleanup of old files
Health checks
Docker support
MCP server with stdio and HTTP transport options
Related MCP server: YouTube Search & Download MCP Server
The system consists of:
MCP Server: Exposes tools for inspecting URLs, starting downloads, checking status, etc.
Worker: Processes download jobs in isolated child processes
Database: SQLite database for storing job state and progress
Services: Business logic for metadata extraction, downloads, cleanup, etc.
This project follows the Python standards defined in ~/.claude/docs/index.md.
# Clone the repository
git clone <repository-url>
cd mcp-video-downloader
# Install dependencies
uv sync
# Run tests
uv run pytest# Run the MCP server (stdio transport)
uv run python -m mcp_video_downloader.mcp.server
# Run the worker
uv run python -m mcp_video_downloader.workerMIT
This server cannot be deployed
Download YouTube, TikTok, Vimeo, SoundCloud and 6 more platforms from any MCP AI chatbot.
yt-dlp Video Link Extractor - Any URL to Links, 1000+ Sites
Transform video, audio and images, and generate media from prompts. FFmpeg, captions, models.
SubDownload exposes YouTube as an MCP-native data source. Connect via OAuth and your AI agent can summarize videos, fetch full transcripts (even for videos with no captions, via AI ASR), search across channels, and save everything into a private knowledge base. Works with Claude, ChatGPT, Cursor, and 40+ MCP clients. Free credits on signup, no card required.
