mcpField
🎧
🎧 MCP Playlist Generator

🎧 MCP Playlist Generator

Local
github.com/m4dd0cDeveloper Tools5Updated 80w ago
Repository

About 🎧 MCP Playlist Generator

An MCP server that scans local music files, matches their metadata to a requested mood or theme, and saves an `.m3u` playlist. It is intended for Claude and other assistants that can use tools.

Key features

  1. 01Scans local music files
  2. 02Reads track metadata
  3. 03Filters tracks by mood or theme
  4. 04Writes `.m3u` playlists

Use cases

  1. 01Create a playlist for a requested mood
  2. 02Save a playlist to a chosen directory

MCP support

Exposes playlist-generation capabilities to Claude and other MCP-compatible assistants. The server reads local music files and saves generated `.m3u` playlists to a specified directory.

#playlist-mcp#music-generator#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

🎧 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.