mcp-apple-music 是一个 MCP（Model Context Protocol）服务器，为 Claude 提供对 Apple Music 账户的完整访问能力。通过它，用户可以用自然语言让 Claude 搜索 Apple Music 曲库、浏览个人音乐库、管理播放列表，并探索收听历史与个性化推荐。
主要能力
- 搜索 Apple Music 曲库
- 浏览个人音乐库
- 管理播放列表（创建、添加歌曲等）
- 查看收听历史与推荐
- 支持示例提问，例如：
- “根据我最近的收听记录，推荐 15 首我还没有的歌曲，并添加到新播放列表”
- “显示我所有的播放列表，并告诉我出现最多的艺术家”
- “搜索 Nick Cave 的专辑，把我最喜欢的三张添加到一个叫 Dark Picks 的播放列表”
使用方式
前置要求
- uv（推荐）或 pip
- 付费 Apple Developer Program 会员资格（99 美元/年），用于创建 MusicKit 密钥。免费 Apple Developer 账户无法创建 MusicKit 密钥。
- 有效的 Apple Music 订阅
步骤
- 创建 MusicKit 密钥：
- 访问 developer.apple.com → Certificates, Identifiers & Profiles
- 在 Keys 下点击 + 创建新密钥
- 命名并启用 MusicKit，点击 Continue → Register
- 下载 .p8 文件（只能下载一次，请妥善保存）
- 记录 Key ID（例如 ABC123DEF4）和 Team ID（在 Membership Details 中查看）
- 注意：Key ID 是密钥名称旁边的字母数字代码，不是 .p8 文件名。
- 克隆并安装（具体命令未在资料中提供）。
- 运行一次性设置向导：向导会询问 Team ID、Key ID 和 .p8 文件路径，然后打开浏览器页面点击“Authorise Apple Music”，使用 Apple 官方 MusicKit JS 获取 Music User Token，并安全存储在 ~/.config/mcp-apple-music/config.json（文件权限 600）。
- 添加到 Claude Desktop：
- 打开 Claude Desktop 配置：macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json
- 重启 Claude Desktop，即可在工具栏看到 apple-music 工具。
令牌机制
Apple Music 需要两种令牌：
- Developer Token：使用 .p8 私钥在本地签名的 JWT，有效期最长 6 个月，服务器会在过期前自动重新生成。密钥不会离开用户机器。
- Music User Token：通过浏览器中的 MusicKit JS OAuth 一次性获取（设置向导处理），本地存储在 ~/.config/mcp-apple-music/config.json。
限制
- 播放控制（播放/暂停/跳过）无法通过 Apple REST API 实现，需要原生 MusicKit 框架（iOS/macOS 应用）或浏览器环境中的 MusicKit JS。
- 如需播放控制，可参考 chrome-relay——一个配套 CLI，让 MCP 服务器驱动已在 Chrome 中打开的 music.apple.com 标签页，实现播放/暂停/跳过，而无需提供 MusicKit JS 垫片。
项目信息
- 由 Cifero74 和 Claude（Anthropic）构建，作为 Claude Desktop 个人 MCP 生态系统的一部分。
- 采用 MIT 许可证，欢迎贡献、问题和 PR。
- 项目结构未在资料中详细说明。
