Mpd MCP Server

🚀 mcp-music-player-daemon 服務端

mcp-music-player-daemon 是一個將 MPD（音樂播放器守護進程）與 MCP（模型上下文協議）集成的服務器。它通過把 MPD 操作作為 MCP 工具，支持音樂播放和播放列表管理等功能，為音樂控制提供了便捷的解決方案。

🚀 快速開始

mcp-music-player-daemon 是一個將 MPD 與 MCP 集成的服務器，藉助 MCP 協議實現對 MPD 的操作，支持音樂播放和播放列表管理等功能。

✨ 主要特性

• MPD 集成：連接到 MPD 服務器以執行播放、暫停、跳過以及管理播放列表等操作。
• MCP 工具支持：將 MPD 操作作為 MCP 協議的工具進行暴露，實現音樂控制功能。
• 靈活配置：允許通過環境變量設置 MPD 服務器地址和端口。

📦 安裝指南

在安裝本項目前，請確保你已經安裝了以下環境：

• Go 1.24.1 或更高版本
• MPD 服務器
• 支持 MCP 協議的客戶端

使用以下命令進行安裝：

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

💻 使用示例

基礎用法

# 設置環境變量（如有需要）
export MPD_SERVER=localhost
export MPD_PORT=6600

# 啟動服務器
mpd-mcp-server

可用工具

• 搜索：在 MPD 數據庫中搜索歌曲。
• 播放：從播放列表中播放一首歌曲。
• 暫停：暫停當前正在播放的歌曲。
• 停止：停止當前正在播放的歌曲。
• 繼續：恢復已暫停的歌曲播放。
• 下一首：跳到播放列表中的下一首歌曲。
• 上一首：跳到播放列表中的上一首歌曲。
• 獲取狀態：查看 MPD 服務器的當前狀態。
• 當前播放歌曲：顯示正在播放的歌曲信息。
• 獲取播放列表：查看當前播放列表內容。
• 清除播放列表：清空當前播放列表。
• 添加到播放列表：將一首歌曲添加到當前播放列表中。

📄 許可證

本項目採用 MIT 許可證進行開源。

👥 項目貢獻

對於任何問題或功能需求，請使用 GitHub Issues 提交。我們也歡迎社區提交 Pull Request，共同完善該項目。