Mpd MCP Server

🚀 mcp-music-player-daemon Server

The mcp-music-player-daemon is a server that integrates MPD (Music Player Daemon) with MCP (Model Context Protocol). This project supports functions such as music playback and playlist management by providing MPD operations as MCP tools.

🚀 Quick Start

The mcp-music-player-daemon combines MPD and MCP, enabling users to control music playback and manage playlists through MCP tools.

✨ Features

• MPD Integration: Connect to the MPD server to perform operations like play, pause, skip, and manage playlists.
• MCP Tool Support: Expose MPD operations as tools in the MCP protocol to achieve music control functions.
• Flexible Configuration: Allow setting the MPD server address and port via environment variables.

📦 Installation

Prerequisites

• Go 1.24.1 or higher
• MPD server
• Client supporting the MCP protocol

Installation Steps

go install github.com/gamoutatsumi/mpd-mcp-server@latest

💻 Usage Examples

Basic Usage

# Set environment variables (if necessary)
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 currently playing song.
• Stop: Stop the currently playing song.
• Resume: Resume the paused song.
• Next: Skip to the next song in the playlist.
• Previous: Skip to the previous song in the playlist.
• Get Status: Check the current status of the MPD server.
• Current Song: Display information about the currently playing song.
• Get Playlist: View the contents of the current playlist.
• Clear Playlist: Empty the current playlist.
• Add to Playlist: Add a song to the current playlist.

📄 License

This project is open - sourced under the MIT License.

🤝 Contribution

For any issues or feature requests, please submit them using GitHub Issues. We also welcome the community to submit Pull Requests to improve this project together.