Youtube Music MCP Server

🚀 YouTube Music MCP Server

This project implements a server based on the Model Context Protocol (MCP), enabling AI models to control YouTube Music playback via Google Chrome. It bridges the gap between AI assistants and music playback, allowing AIs to search for and play songs by song name and artist name.

🚀 Quick Start

This project offers a server based on the Model Context Protocol (MCP), which enables AI models to control YouTube Music playback through Google Chrome. It allows AI to search for and play songs according to song names and artist names.

✨ Features

• Search for songs on YouTube Music.
• Play songs directly in Google Chrome.
• Support searching by song name and artist name.
• Error handling and logging.
• Cross - platform support (mainly for Chrome automation on macOS).

📚 Documentation

What is MCP?

The Model Context Protocol (MCP) is a standardized way for AI models to interact with external tools and services. It provides a structured communication protocol that enables AI assistants to:

• Discover available tools.
• Understand the functionality of tools.
• Perform operations through these tools.
• Handle responses and errors.

Learn more about MCP:

• MCP Documentation
• MCP SDK

Architecture

High - level Overview

This is a TypeScript - based MCP server that implements a simple note - taking system. It demonstrates core MCP concepts through the following features:

• List and access text notes with metadata via note:// URIs.
• Each note has a title, content, and metadata.
• A simple text mime type is used for basic content access.

Tools

• create_note - Create a new text note.
  • Accepts title and content as required parameters.
  • Stores the note in the server state.

Prompts

• summarize_notes - Generate a summary of all stored notes.
  • Includes all note content as embedded resources.
  • Returns a structured prompt for LLM summarization.

📦 Installation

To use with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "youtube-music-server": {
      "command": "/path/to/youtube-music-server/build/index.js"
    }
  }
}

Debugging

Since MCP servers communicate via stdio, debugging can be challenging. We recommend using MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL in the browser to access debugging tools.

🔧 Technical Details

Development

Install dependencies:

npm install

Build the server:

npm run build

Develop with automatic rebuild:

npm run watch