mpd-mcp-server

基本能力

产品定位

mpd-mcp-server 是一个音乐播放管理服务，通过 MCP 协议提供对 MPD 服务器的操作能力。

核心功能

• MPD 集成：连接到 MPD 服务器，执行播放、暂停、跳过和管理播放列表等操作。
• MCP 工具支持：将 MPD 操作作为 MCP 工具暴露。
• 灵活配置：允许通过环境变量配置 MPD 服务器地址和端口。

适用场景

• 音乐播放管理
• 播放列表管理
• 音乐播放状态监控

工具列表

• search：在 MPD 数据库中搜索歌曲。
• play：播放播放列表中的歌曲。
• pause：暂停当前歌曲。
• stop：停止当前歌曲。
• resume：恢复暂停的歌曲。
• next：跳到下一首歌曲。
• previous：跳到上一首歌曲。
• get_status：获取 MPD 服务器的当前状态。
• get_current_song：获取当前播放的歌曲。
• get_playlist：获取当前播放列表。
• clear_playlist：清空当前播放列表。
• add_playlist：添加歌曲到当前播放列表。

常见问题解答

• 如何配置 MPD 服务器地址和端口？ 通过设置环境变量 MPD_SERVER 和 MPD_PORT。
• 如何启动服务器？ 运行 mpd-mcp-server 命令。

使用教程

使用依赖

• 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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。