MCP Video Downloader

An MCP (Model Context Protocol) server for downloading videos and audio from various platforms using yt-dlp.

Features

• 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

Architecture

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.

Development

This project follows the Python standards defined in ~/.claude/docs/index.md.

Setup

# Clone the repository
git clone <repository-url>
cd mcp-video-downloader

# Install dependencies
uv sync

# Run tests
uv run pytest

Running

# 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.worker

License

MIT