Skip to main content

YouTube MCP server using FastMCP and you-get for downloading videos

Project description

YouTube MCP Server

A Model Context Protocol (MCP) server that provides YouTube video downloading capabilities using FastMCP and you-get.

Features

  • Download YouTube videos in various formats
  • Get video information without downloading
  • List available video formats
  • Configurable output directory
  • Built with FastMCP for easy integration

Installation

From PyPI

pip install youtube-mcp-server

From Source

git clone https://github.com/yzfly/youtube-mcp-server.git
cd youtube-mcp-server
pip install -e .

Prerequisites

This server requires you-get to be installed:

pip install you-get

Usage

Running the Server

youtube-mcp-server

The server runs on stdio transport by default, making it compatible with Claude Desktop and other MCP clients.

Available Tools

download_youtube_video

Downloads a YouTube video.

Parameters:

  • url (str): YouTube video URL
  • output_dir (str, optional): Output directory for downloaded files
  • format_type (str, optional): Preferred video format (e.g., 'mp4', 'flv')
  • info_only (bool): If True, only returns video info without downloading

get_video_info

Gets video information without downloading.

Parameters:

  • url (str): YouTube video URL

list_available_formats

Lists all available formats for a video.

Parameters:

  • url (str): YouTube video URL

Configuration

Claude Desktop Integration

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "youtube-mcp-server": {
      "command": "youtube-mcp-server"
    }
  }
}

Development

Setup

git clone https://github.com/yzfly/youtube-mcp-server.git
cd youtube-mcp-server
pip install -e ".[dev]"

Testing

pytest

License

MIT License

Author

Created by yzfly

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

youtube_mcp_server-0.1.0.tar.gz (259.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

youtube_mcp_server-0.1.0-py3-none-any.whl (2.9 kB view details)

Uploaded Python 3

File details

Details for the file youtube_mcp_server-0.1.0.tar.gz.

File metadata

  • Download URL: youtube_mcp_server-0.1.0.tar.gz
  • Upload date:
  • Size: 259.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.2

File hashes

Hashes for youtube_mcp_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 90bb4e3c12383bc18e236dac4e8fe03b0fa65fb046ac5b95efb12e3042c9c4ad
MD5 402f332e6dca54b9b3f21984832476d6
BLAKE2b-256 f19d7f0ee8efb39d348cf1bd6bfb16aeb30eb36f51ea9fa900128b21d81aee7f

See more details on using hashes here.

File details

Details for the file youtube_mcp_server-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for youtube_mcp_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4075b3e4e9e37c99aa60c8fc4c34b91141412d1f9896a0d0f379c2c7d296e1ec
MD5 275799795e3972ca568cdf9181d7fa6c
BLAKE2b-256 66a68839bda195681eff7f43373e31edda2d7526212bc1ebdc3c5376892a7d77

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page