About mpd-mcp-server
mpd-mcp-server connects MPD to MCP-compatible clients, making music playback and playlist operations available as tools. It is intended for people who want to control an MPD server through MCP.
Key features
- 01MPD 服务器连接
- 02播放、暂停、停止与切歌
- 03搜索曲目并管理播放列表
- 04查询播放状态和当前曲目
- 05通过环境变量配置地址和端口
Use cases
- 01通过 MCP 客户端控制 MPD 播放
- 02搜索 MPD 曲库并将歌曲加入播放列表
MCP support
将 MPD 的搜索、播放控制、状态查询和播放列表操作作为 MCP 工具提供给客户端。
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEmpd-mcp-server
mpd-mcp-server is a server that integrates MPD (Music Player Daemon) with MCP (Model Context Protocol). This project provides MPD operations as MCP tools, supporting features like music playback and playlist management.
Features
- MPD Integration: Connects to an MPD server to perform operations like play, pause, skip, and manage playlists.
- MCP Tool Support: Exposes MPD operations as tools using the MCP protocol.
- Flexible Configuration: Allows configuration of the MPD server address and port using environment variables.
Prerequisites
- Go 1.24.1 or later
- MPD server
- MCP protocol-compatible client
Installation
go install github.com/gamoutatsumi/mpd-mcp-server@latest
Usage
# Set environment variables (if needed)
export MPD_SERVER=localhost
export MPD_PORT=6600
# Start the server
mpd-mcp-server
Available Tools
search: Search for songs in the MPD database.play: Play a song from the playlist.pause: Pause the current song.stop: Stop the current song.resume: Resume the paused song.next: Skip to the next song.previous: Skip to the previous song.get_status: Get the current status of the MPD server.get_current_song: Get the currently playing song.get_playlist: Get the current playlist.clear_playlist: Clear the current playlist.add_playlist: Add a song to the current playlist.
License
This project is licensed under the MIT License.
Contributing
For bug reports or feature requests, please use GitHub Issues. Pull requests are also welcome.
Comments
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.