What is the YouTube Music MCP Server?

The YouTube Music MCP Server is an AI-powered tool that allows users to discover music using natural language. It understands requests based on mood, activity, or artist and provides relevant music suggestions from YouTube.

How does the MCP Server work?

The MCP Server uses Natural Language Processing (NLP) to interpret user requests and then utilizes the YouTube Data API v3 to search for music. It filters and categorizes the results based on the user’s input.

What is the Model Context Protocol (MCP)?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). It allows AI models to interact with external data sources and tools.

What kind of searches can I perform?

You can search for music by mood (e.g., happy, sad), activity (e.g., exercise, study), or artist. You can also request trending music for a specific region or find live music streams.

How do I install the MCP Server?

First, clone the repository and install the required dependencies using pip install -r requirements.txt. Then, obtain a YouTube Data API v3 key from the Google Cloud Console and set it as an environment variable.

Do I need a YouTube API key to use the MCP Server?

Yes, a YouTube Data API v3 key is required. You can obtain one from the Google Cloud Console.

How do I set up the environment variables?

Set the YOUTUBE_API_KEY environment variable with your YouTube API key and optionally set the DEFAULT_REGION variable with your preferred region code (e.g., TR for Turkey).

How can I test the MCP Server?

After starting the server, you can test it by sending a JSON payload to the server via the command line. For example: echo '{"method": "tools/call", "params": {"name": "search_music", "arguments": {"query": "pop music"}}}' | python server.py

What is the API quota for YouTube Data API v3?

The YouTube Data API v3 has a daily quota of 10,000 units. Each search operation consumes approximately 100 units, allowing for about 100 searches per day.

Can I run the MCP Server using Docker?

Yes, you can build and run the MCP Server using Docker. Create a Docker image using the provided Dockerfile and run the container with the necessary environment variables.

How does the MCP Server integrate with UBOS?

The MCP Server can be integrated into UBOS-powered applications to provide AI-powered music discovery features. This allows developers to create intelligent music experiences leveraging the full power of AI.

What kind of error handling does the MCP Server have?

The MCP Server handles various error scenarios, including missing API keys, quota limits, network errors, and invalid search parameters. It also provides detailed logging for debugging.

How can I contribute to the project?

You can contribute by forking the repository, creating feature branches, and submitting pull requests.

What license is the project under?

The project is licensed under the MIT License.

Can I use this MCP Server in a commercial application?

Yes, the MIT License allows you to use the MCP Server in commercial applications. However, ensure that you comply with YouTube’s terms of service and API usage policies.