Video Downloader

Provides video checking, analysis, and download capabilities across 1000+ platforms with secure, configurable storage.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "chazmaniandinkle-video-downloader-mcp": {
      "command": "python",
      "args": [
        "/path/to/video-downloader-mcp/server.py"
      ]
    }
  }
}

This Video Downloader MCP Server empowers agents to locate, analyze, and securely download videos from 1000+ sites using a set of discrete tools built on yt-dlp. It emphasizes safe downloads, structured responses, and easy integration with MCP clients so you can automate media collection with confidence.

How to use

You integrate the Video Downloader MCP Server with your MCP client and call its tools to check support, fetch formats, and perform secure downloads. Start by validating whether a URL is supported, then inspect available video formats, and finally download the chosen format to a designated secure location. If yt-dlp cannot handle a site, you can trigger a fallback analysis to discover alternative video URLs.

Typical end-to-end usage pattern from an agent perspective:

How to install

Prerequisites you need before installation are Python and a working internet connection.

Install the Python dependencies required by the MCP server.

Install dependencies using the Python package manager.

pip install mcp yt-dlp requests aiohttp

If you are using Python version older than 3.11, install tomli as well.

pip install tomli

Clone the MCP server repository and navigate into the project directory.

git clone https://github.com/chazmaniandinkle/video-downloader-mcp.git
cd video-downloader-mcp

Ensure the MCP client configuration points to the server entry for the Video Downloader MCP Server.

Configuration

{
  "mcpServers": {
    "video-downloader": {
      "command": "python",
      "args": ["/path/to/video-downloader-mcp/server.py"]
    }
  }
}

First download

With the MCP client configured, you can start a download by performing a simple sequence: check support for the URL, get available video formats, then download the chosen format to the secure location.

Example workflow you can replicate in your agent:

Security notes

The server includes built-in protections to keep downloads safe, including path traversal prevention, location restrictions, and input sanitization. Always download only to configured safe locations and validate file extensions against allowed types.

Troubleshooting

If downloads fail, verify the yt-dlp installation and ensure the target directory has proper permissions. Check the configured download locations and review the security settings to confirm they are enforcing the intended constraints.

Additional notes

The server provides structured JSON responses and clear error handling to make integration with agents straightforward. You can customize the default download location, filename templates, and security policies via the configuration files provided in the project.

Available tools

check_ytdlp_support

Check if a URL is supported by yt-dlp and get basic info

get_video_info

Extract metadata such as duration and quality

get_video_formats

List available download formats and their details

download_video

Perform a secure download to a configured location using a chosen format

get_download_locations

Show safe, configured download destinations

analyze_webpage

Fallback analysis to determine how to extract media when direct support is missing

extract_media_patterns

Pattern matching to locate video URLs within HTML or pages