【技术文档摘要】：

MCP-AppleMusic

这是一个通过AppleScript命令在macOS上控制Apple Music（以前称为iTunes）的FastMCP服务器实现。

要求

• Python 3.13+
• 已安装Apple Music应用的macOS系统
• MCP库 ≥1.2.1

安装

首先，确保已安装uv：

$ brew install uv

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

{
  "mcpServers": {
    "iTunesControlServer": {
      "command": "uvx",
      "args": ["-p", "3.13", "-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 '添加精彩功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

本项目采用MIT许可证——详情见LICENSE文件。

注意事项

• 由于依赖于AppleScript，此工具仅适用于macOS系统
• 需要安装Apple Music（以前称为iTunes）