MCP-AppleMusic

一个快速的MCP服务器实现，用于通过AppleScript命令控制macOS上的Apple Music（以前称为iTunes）。

要求

• Python 3.13+
• macOS安装了Apple Music应用程序
• MCP库 ≥1.2.1

安装

首先确保已安装uv：

$ brew install uv

然后，使用Claude Desktop，在claude_desktop_config.json中添加以下内容：

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

可用命令

通过MCP服务器可用的以下命令：

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

使用

启动服务器：

python server.py

示例交互：

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

# 创建新播放列表
itunes_create_playlist("披头士最爱", ["Yesterday", "Hey Jude", "Let It Be"])

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

开发

1. 克隆仓库：

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

2. 安装开发依赖项：

pip install -e ".[dev]"

贡献

1. 叉克隆仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request

许可证

此项目根据MIT许可证发布，详情请参阅LICENSE文件。

注意事项

• 该工具仅在macOS系统上有效，由于其AppleScript依赖
• 需要安装Apple Music（以前称为iTunes）