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": ["-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("Beatles Favorites", ["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. Fork 存储库
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 文件。

注意

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