Knuckles-Team/media-downloader
3.3
If you are the rightful owner of media-downloader and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Media Downloader is a versatile tool designed to download videos and audio from various online platforms, supporting both CLI and MCP server functionalities.
Tools
1
Resources
0
Prompts
0
Media Downloader
Version: 2.1.12
Download videos and audio from the internet!
MCP Server Support!
This repository is actively maintained - Contributions are welcome!
Supports:
- YouTube
- Rumble
- BitChute
- Vimeo
- And More!
Usage:
CLI
| Short Flag | Long Flag | Description |
|---|---|---|
| -h | --help | See usage |
| -a | --audio | Download audio only |
| -c | --channel | YouTube Channel/User - Downloads all videos |
| -f | --file | File with video links |
| -l | --links | Comma separated links |
| -d | --directory | Location to save videos |
media-downloader --file "C:\Users\videos.txt" --directory "C:\Users\Downloads" --channel "WhiteHouse" --links "URL1,URL2,URL3"
MCP CLI
| Short Flag | Long Flag | Description |
|---|---|---|
| -h | --help | Display help information |
| -t | --transport | Transport method: 'stdio', 'http', or 'sse' [legacy] (default: stdio) |
| -s | --host | Host address for HTTP transport (default: 0.0.0.0) |
| -p | --port | Port number for HTTP transport (default: 8000) |
| --auth-type | Authentication type: 'none', 'static', 'jwt', 'oauth-proxy', 'oidc-proxy', 'remote-oauth' (default: none) | |
| --token-jwks-uri | JWKS URI for JWT verification | |
| --token-issuer | Issuer for JWT verification | |
| --token-audience | Audience for JWT verification | |
| --oauth-upstream-auth-endpoint | Upstream authorization endpoint for OAuth Proxy | |
| --oauth-upstream-token-endpoint | Upstream token endpoint for OAuth Proxy | |
| --oauth-upstream-client-id | Upstream client ID for OAuth Proxy | |
| --oauth-upstream-client-secret | Upstream client secret for OAuth Proxy | |
| --oauth-base-url | Base URL for OAuth Proxy | |
| --oidc-config-url | OIDC configuration URL | |
| --oidc-client-id | OIDC client ID | |
| --oidc-client-secret | OIDC client secret | |
| --oidc-base-url | Base URL for OIDC Proxy | |
| --remote-auth-servers | Comma-separated list of authorization servers for Remote OAuth | |
| --remote-base-url | Base URL for Remote OAuth | |
| --allowed-client-redirect-uris | Comma-separated list of allowed client redirect URIs | |
| --eunomia-type | Eunomia authorization type: 'none', 'embedded', 'remote' (default: none) | |
| --eunomia-policy-file | Policy file for embedded Eunomia (default: mcp_policies.json) | |
| --eunomia-remote-url | URL for remote Eunomia server |
Using as an MCP Server
The MCP Server can be run in two modes: stdio (for local testing) or http (for networked access). To start the server, use the following commands:
Run in stdio mode (default):
media-downloader-mcp
Run in HTTP mode:
media-downloader-mcp --transport http --host 0.0.0.0 --port 8012
AI Prompt:
Download me this video: https://youtube.com/watch?askdjfa
AI Response:
Sure thing, the video has been downloaded to:
"C:\Users\User\Downloads\YouTube Video - Episode 1.mp4"
Use in Python
# Import library
from media_downloader import MediaDownloader
# Set URL of video/audio here
url = "https://YootToob.com/video"
# Instantiate vide_downloader_instance
video_downloader_instance = MediaDownloader()
# Set the location to save the video
video_downloader_instance.set_save_path("C:/Users/you/Downloads")
# Add URL to download
video_downloader_instance.append_link(url)
# Download all videos appended
video_downloader_instance.download_all()
# Optional - Set Audio to True, Default is False if unspecified.
video_downloader_instance.set_audio(audio=True)
# Optional - Open a file of video/audio URL(s)
video_downloader_instance.open_file("FILE")
# Optional - Enter a YouTube channel name and download their latest videos
video_downloader_instance.get_channel_videos("YT-Channel Name")
Deploy MCP Server as a Service
The MCP server can be deployed using Docker, with configurable authentication, middleware, and Eunomia authorization.
Using Docker Run
docker pull knucklessg1/media-downloader:latest
docker run -d \
--name media-downloader-mcp \
-p 8004:8004 \
-e HOST=0.0.0.0 \
-e PORT=8004 \
-e TRANSPORT=http \
-e AUTH_TYPE=none \
-e EUNOMIA_TYPE=none \
-e DOWNLOAD_DIRECTORY=/downloads \
-e AUDIO_ONLY=false \
-v "/home/genius/Downloads:/downloads" \
knucklessg1/media-downloader:latest
For advanced authentication (e.g., JWT, OAuth Proxy, OIDC Proxy, Remote OAuth) or Eunomia, add the relevant environment variables:
docker run -d \
--name media-downloader-mcp \
-p 8004:8004 \
-e HOST=0.0.0.0 \
-e PORT=8004 \
-e TRANSPORT=http \
-e AUTH_TYPE=oidc-proxy \
-e OIDC_CONFIG_URL=https://provider.com/.well-known/openid-configuration \
-e OIDC_CLIENT_ID=your-client-id \
-e OIDC_CLIENT_SECRET=your-client-secret \
-e OIDC_BASE_URL=https://your-server.com \
-e ALLOWED_CLIENT_REDIRECT_URIS=http://localhost:*,https://*.example.com/* \
-e EUNOMIA_TYPE=embedded \
-e EUNOMIA_POLICY_FILE=/app/mcp_policies.json \
-e DOWNLOAD_DIRECTORY=/downloads \
-e AUDIO_ONLY=false \
-v "/home/genius/Downloads:/downloads" \
knucklessg1/media-downloader:latest
Using Docker Compose
Create a docker-compose.yml file:
services:
media-downloader-mcp:
image: knucklessg1/media-downloader:latest
environment:
- HOST=0.0.0.0
- PORT=8004
- TRANSPORT=http
- AUTH_TYPE=none
- EUNOMIA_TYPE=none
- DOWNLOAD_DIRECTORY=/downloads
- AUDIO_ONLY=false
volumes:
- "/home/genius/Downloads:/downloads"
ports:
- 8004:8004
For advanced setups with authentication and Eunomia:
services:
media-downloader-mcp:
image: knucklessg1/media-downloader:latest
environment:
- HOST=0.0.0.0
- PORT=8004
- TRANSPORT=http
- AUTH_TYPE=oidc-proxy
- OIDC_CONFIG_URL=https://provider.com/.well-known/openid-configuration
- OIDC_CLIENT_ID=your-client-id
- OIDC_CLIENT_SECRET=your-client-secret
- OIDC_BASE_URL=https://your-server.com
- ALLOWED_CLIENT_REDIRECT_URIS=http://localhost:*,https://*.example.com/*
- EUNOMIA_TYPE=embedded
- EUNOMIA_POLICY_FILE=/app/mcp_policies.json
- DOWNLOAD_DIRECTORY=/downloads
- AUDIO_ONLY=false
ports:
- 8004:8004
volumes:
- ./mcp_policies.json:/app/mcp_policies.json
- "/home/genius/Downloads:/downloads"
Run the service:
docker-compose up -d
Configure mcp.json for AI Integration
{
"mcpServers": {
"media_downloader": {
"command": "uv",
"args": [
"run",
"--with",
"media-downloader",
"media-downloader-mcp"
],
"env": {
"DOWNLOAD_DIRECTORY": "~/Downloads", // Optional - Can be specified at prompt
"AUDIO_ONLY": false // Optional - Can be specified at prompt
},
"timeout": 300000
}
}
}
Installation Instructions:
Install Python Package
python -m pip install --upgrade media-downloader
or
uv pip install --upgrade media-downloader
Repository Owners:
