MCP-AppleMusic

基本能力

产品定位

mcp-applemusic 是一个专门用于控制 Apple Music 的 MCP 服务，适用于需要在 macOS 上自动化控制音乐播放的场景。

核心功能

• 播放控制：开始播放、暂停播放、下一曲、上一曲
• 歌曲搜索：在音乐库中搜索特定歌曲
• 播放特定歌曲
• 创建和管理播放列表
• 获取音乐库统计信息

适用场景

• 自动化音乐播放流程
• 批量创建和管理播放列表
• 通过脚本控制音乐播放
• 集成到其他自动化工作流中

工具列表

• itunes_play(): 开始播放
• itunes_pause(): 暂停播放
• itunes_next(): 跳到下一曲
• itunes_previous(): 返回上一曲
• itunes_search(query): 搜索音乐库中的歌曲
• itunes_play_song(song): 播放特定歌曲
• itunes_create_playlist(name, songs): 创建新播放列表
• itunes_library(): 获取音乐库统计信息

常见问题解答

• 仅支持 macOS 系统
• 需要安装 Apple Music（原 iTunes）
• 依赖 AppleScript 功能

使用教程

使用依赖

• Python 3.13+
• macOS 系统
• Apple Music 应用
• MCP 库 ≥1.2.1

安装 uv:

$ brew install uv

安装教程

1. 在 Claude Desktop 的 claude_desktop_config.json 中添加以下配置:

{
  "mcpServers": {
    "iTunesControlServer": {
      "command": "uvx",
      "args": ["-n", "mcp-applemusic"]
    }
  }
}

1. 启动服务器:

python server.py

调试方式

1. 克隆仓库:

git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic

1. 安装开发依赖:

pip install -e ".[dev]"

1. 运行示例命令进行测试:

# 搜索歌曲
results = itunes_search("Hey Jude")

# 创建播放列表
itunes_create_playlist("Beatles Favorites", ["Yesterday", "Hey Jude", "Let It Be"])

# 播放特定歌曲
itunes_play_song("Hey Jude")

许可证

该项目遵循 MIT 开源许可条款。