Overview
What is mpd-mcp-server?
mpd-mcp-server integrates MPD (Music Player Daemon) with the Model Context Protocol (MCP), exposing MPD operations as MCP tools. It is intended for users who want to control music playback and playlists from any MCP-compatible client.
How to use mpd-mcp-server?
Install with go install github.com/gamoutatsumi/mpd-mcp-server@latest. Optionally set MPD_SERVER and MPD_PORT environment variables, then run mpd-mcp-server. The server connects to MPD and makes tools available via MCP.
Key features of mpd-mcp-server
- Connects to an MPD server for playback and playlist operations.
- Exposes MPD operations as MCP tools.
- Configurable MPD server address and port via environment variables.
- Supports search, play, pause, stop, resume, skip, and playlist management.
Use cases of mpd-mcp-server
- Control music playback from an AI assistant or MCP-compatible client.
- Automate playlist management in a MCP-based workflow.
- Integrate MPD into a larger MCP ecosystem for media control.
FAQ from mpd-mcp-server
What are the prerequisites to run mpd-mcp-server?
Go 1.24.1 or later, a running MPD server, and an MCP protocol‑compatible client.
How do I configure the MPD server connection?
Set the MPD_SERVER and MPD_PORT environment variables before starting the server.
What MPD tools does mpd-mcp-server provide?
It provides twelve tools: search, play, pause, stop, resume, next, previous, get_status, get_current_song, get_playlist, clear_playlist, and add_playlist.
How do I install mpd-mcp-server?
Run go install github.com/gamoutatsumi/mpd-mcp-server@latest.
Is mpd-mcp-server open source? What is its license?
Yes, it is licensed under the MIT License.
