Apple Music MCP 服务器

一个用于与 Apple Music API 交互的 MCP 服务器。此服务器提供搜索歌曲、生成播放链接的工具。

功能

• 按标题、艺术家或专辑搜索歌曲
• 生成歌曲和播放列表的深度链接
• 简单的命令行界面
• 使用模型上下文协议 (MCP) 与客户端交互

要求

• Rust (nightly, 因为 rmcp)
• 具有 Apple Music API 访问权限的 Apple Developer 帐户
• Apple Music API 密钥 (.p8 文件)

安装

# 构建项目
cargo install --path .

用法

Apple Music MCP 服务器需要身份验证凭据才能访问 Apple Music API。这些凭据通过命令行参数提供。

cargo run -- --team-id YOUR_TEAM_ID --key-id YOUR_KEY_ID --private-key-path /path/to/AuthKey.p8

命令行参数

用法: applemusic-mcp-server [OPTIONS]

选项:
--team-id <TEAM_ID>                    Apple Developer 团队 ID
--key-id <KEY_ID>                      Apple Music 密钥 ID
--private-key-path <PRIVATE_KEY_PATH>  Apple Music 私钥文件 (.p8) 的路径
--storefront <STOREFRONT>              Apple Music 的商店区域 (例如 us, jp) [默认: jp]
-h, --help                                 打印帮助信息
-V, --version                              打印版本信息

API 工具

searchSongs

从 Apple Music 中按标题、专辑名称或艺术家姓名搜索歌曲。

参数：

• query: (字符串) - 搜索查询文本

返回值：

• 包含歌曲详细信息的歌曲对象数组，包括标题、艺术家、专辑、时长和 URL

generatePlaybackLink

生成用于播放歌曲或播放列表的深度链接。

参数：

• 必须提供 song_id 或 playlist_id 之一

返回值：

• 包含 Apple Music URL 的对象