mpd-mcp-server

by gamoutatsumi

1 211 downloads Not rated yet MIT

About

# mpd-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…

Details

License
MIT

Explore

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

- Go 1.24.1 or later
- MPD server
- MCP protocol-compatible client

export MPD_SERVER=localhost
export MPD_PORT=6600

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.

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

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

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.