LLM Jukebox MCP Server

A Model Context Protocol (MCP) server that enables LLMs to search, download, and extract information from YouTube music videos.

Features

• YouTube Music Search: Find music videos by artist, song title, album, or any search query

• Audio Download: Download and convert YouTube videos to high-quality MP3 files

• Video Information: Extract detailed metadata from YouTube videos

• Async Operations: Non-blocking downloads and searches with progress tracking

• Logging: Debug-level logging to file and stderr

Environment Variables

• DOWNLOAD_PATH: Directory for downloaded files (defaults to current directory)

Example:

export DOWNLOAD_PATH="/Users/username/Music/Downloads"

MCP Server Configuration

Add this configuration to your MCP settings file (typically mcp_servers.json or similar):

{
  "mcpServers": {
    "llm-jukebox": {
      "command": "uv",
      "args": ["run", "python", "/path/to/your/main.py"],
      "env": {
        "DOWNLOAD_PATH": "/path/to/downloads"
      }
    }
  }
}

Related MCP server: mcp-youtube-sheets

Available Tools

test_ytdlp()

Tests if yt-dlp is properly installed and accessible.

Returns: Version information or error message

search_youtube_music(query: str)

Searches YouTube for music content and returns the URL of the first result.

Parameters:

• query: Search terms (artist, song, album, etc.)

Returns: YouTube watch URL or "No results found" message

Example:

search_youtube_music("Radiohead Creep")
# Returns: https://www.youtube.com/watch?v=XFkzRNyygfk

download_youtube_music(query: str)

Searches for and downloads music, converting to MP3 format.

Parameters:

• query: Search terms for the desired music

Returns: Success message with file paths or error details

Example:

download_youtube_music("The Beatles Yesterday")
# Downloads and converts to MP3 in the configured directory

get_youtube_info(url: str)

Extracts detailed information about a YouTube video without downloading.

Parameters:

• url: YouTube URL or video ID

Returns: JSON-formatted video metadata including title, uploader, duration, view count, upload date, and description

Usage Examples

Once configured with your MCP-compatible client:

1. Search for music: "Find me the YouTube URL for 'Bohemian Rhapsody' by Queen"

2. Download music: "Download 'Hotel California' by Eagles as MP3"

3. Get video information: "Get details about this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ"

4. Test the setup: "Test if yt-dlp is working"

File Naming

Downloaded files use the format: {video_title}.mp3 and are saved to the configured download directory.

Logging

The server creates detailed logs in llm_jukebox_mcp_debug.log including:

• Search and download operations

• Performance timing

• Error details

• File paths of successful downloads

Error Handling

The server gracefully handles:

• Network connectivity issues

• Invalid YouTube URLs

• Missing or corrupted videos

• FFmpeg conversion errors

• File system permissions

Legal Considerations

This tool is intended for personal use with content you have the right to download. Users are responsible for complying with:

• YouTube's Terms of Service

• Local copyright laws

• Content creators' rights

Always respect intellectual property and consider supporting artists through official channels.