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，共同完善该项目。