What is Playlist Mcp Server

playlist-mcp-server is a Model Context Protocol (MCP) server that allows AI agents to create and manage music playlists based on user-defined contexts, such as mood or theme, through context-aware API endpoints.

Use cases

Use cases include generating playlists for specific moods (e.g., happy, chill), creating themed playlists for events, and enhancing user experiences in music applications by integrating with AI assistants.

How to use

To use playlist-mcp-server, install the required packages using ‘pip install uv mutagen’, clone the repository, and run the server with ‘uvicorn mcp_server:app --reload’. You can then prompt an AI assistant like Claude to generate playlists based on your mood.

Key features

Key features include the ability to scan local music files, read metadata using mutagen, filter songs by mood or theme, and generate .m3u playlists that are saved to a user-specified directory.

Where to use

playlist-mcp-server can be used in personal music management, AI-driven applications, and any context-aware music playlist generation scenarios.

🎧 MCP Playlist Generator

This project is a Model Context Provider (MCP) server designed to work with Claude or any AI assistant that supports tool usage. It generates .m3u playlists on the user’s PC based on their current mood or theme. The playlist gets saved to a user-specified directory, ready to be queued up in your favorite media player.

Built with Python, powered by uv and mutagen, and inspired by the legendary Filesystem MCP Server — major shoutout for the idea and foundational reference!

🛠 How It Works

1. User sets up the MCP server using Python and uv.
2. Server listens for requests from Claude or any LLM agent.
3. Based on the request (e.g., “make a chill evening playlist”), it:
   • Scans local music files.
   • Uses mutagen to read metadata (genre, title, artist, etc.).
   • Filters songs matching the vibe.
   • Creates an .m3u playlist.
   • Saves it at the desired location on the user’s machine.

🔧 Tech Stack

• Python
• uv — for the async web server
• mutagen — for metadata extraction

📦 Installation

pip install uv mutagen

Clone this repo and run:

uvicorn mcp_server:app --reload

🧠 Example Claude Prompt

“Hey Claude, can you make me a happy vibe playlist.”

Claude will then use the MCP server tool and boom — you get a playlist in your music app.

[!important]
Make sure you re-index the Music app after creating the playlist.

🙏 Special Thanks

Massive thanks to the Filesystem MCP Server — this project was built with your idea as the spark.

💬 Got Feedback?

Open an issue or hit me up. PRs are welcome, mood-based jams even more so 🎶

Need:

• What’s the default directory fallback if user doesn’t pick a location?
• Are you supporting MP3 only, or other formats too?
• Should I include API route structure for devs?

Lemme know and I’ll update it.