Playlist MCP Server

A Python - based MCP server project that can collaborate with AI assistants such as Claude to generate local music playlists in .m3u format based on the user's mood or theme and save them to the specified directory.

Entertainment and media Artificial intelligence chatbots #Music playback #AI collaboration #Local files .Python

rating : 2.5 points

downloads : 16

update time : 2025-04-29

What is MCP Playlist Generator?

MCP Playlist Generator is an intelligent assistant tool that automatically scans the music files on your computer and generates a matching playlist based on your current mood or favorite music theme. The generated playlist can be directly used in your favorite music player.

How to use MCP Playlist Generator?

Simply tell the AI assistant (such as Claude) what type of playlist you want (e.g., 'Relaxing evening music' or 'Happy background music for work'), and the system will automatically create and save the playlist file.

Use cases

It is especially useful when you want to quickly create a music list for a specific atmosphere, such as parties, work focus, sports, or relaxation moments. It is also suitable for users who have a large number of local music but don't know how to organize them.

Main features

Automatic playlist generationAutomatically create playlists based on the mood or theme you describe

Intelligent music analysisRead the metadata of music files (such as genre, artist, etc.) to match the most suitable songs

Multi - format supportSupport music files in multiple audio formats (such as MP3, etc.)

Custom save locationAllow users to specify the save location of the playlist file

Advantages and limitations

Advantages

Save time without manually selecting songs

Use AI to understand your music preferences

The generated playlists can be directly used in common players

Completely offline processing to protect privacy

Limitations

Need to store music files on the computer in advance

Depend on the accuracy of the music file metadata

Some special music formats may not be supported

Simple settings are required for the first use

How to use

Install necessary software

Install Python and the required libraries (uv and mutagen) on your computer

Start the MCP server

Run the server after cloning the project

Use through the AI assistant

Request to create a playlist in a supported AI assistant (such as Claude)

Refresh in the music player

After creating the playlist, remember to re - index in the music application to view the new list

Usage examples

Create a relaxing music listWant to listen to some relaxing music to unwind after work

Prepare party musicPrepare energetic music for a family party

Frequently Asked Questions

If no save location is specified, where will the playlist be saved?

Which music file formats are supported?

Why doesn't the newly created playlist immediately appear in my music application?

Related resources

uv project homepage

Official documentation of the uv asynchronous network library

mutagen documentation

Official documentation of the music metadata reading library

Filesystem MCP Server

The inspiration source for this project

🚀 Mood Context Provider (MCP) Playlist Generator

This project is a Mood Context Provider (MCP) server designed for AI assistants used by Claude or other supporting tools. It generates .m3u playlists on the user's local computer based on the current mood or theme. The playlists are saved to a user-specified directory and are ready to play in your favorite media player.

🚀 Quick Start

This MCP server is built with Python and powered by uv and mutagen, inspired by the legendary File System MCP Server. Here's how it works and how to get started.

✨ Features

Generate .m3u playlists according to the user's current mood or theme.
Scan local music files and filter songs that match the mood.
Save playlists to a user-specified directory.

📦 Installation

First, install the necessary dependencies:

pip install uv mutagen

Then, clone this repository and run the server:

uvicorn mcp_server:app --reload

💻 Usage Examples

Basic Usage

You can use the following prompt with Claude to generate a playlist:

“Hey Claude, can you create a playlist for a happy mood for me?”

Claude will then use the MCP server tool, and you'll get a playlist in your music application.

⚠️ Important Note

Make sure to re-index your Music application after creating a playlist.

🔧 Technical Details

How It Works

User sets up the MCP server using Python and uv.
The server listens for requests from Claude or other LLM agents.
Based on the request (e.g., “Create a relaxing evening playlist”), it:
- Scans local music files.
- Reads metadata (genre, title, artist, etc.) using mutagen.
- Filters songs that match the mood.
- Creates an .m3u playlist.
- Saves it to a specified location on the user's machine.