Apple Music MCP Server

基本能力

产品定位

Apple Music MCP Server 是一个用于与 Apple Music API 交互的 MCP 服务器，主要用于搜索歌曲和生成播放链接。

核心功能

• 通过标题、艺术家或专辑搜索歌曲
• 生成歌曲和播放列表的深度链接
• 简单的命令行界面
• 使用 Model Context Protocol (MCP) 与客户端交互

适用场景

• 需要集成 Apple Music 搜索功能的应用程序
• 需要生成 Apple Music 播放链接的应用程序

工具列表

• searchSongs: 通过标题、专辑名称或艺术家名称搜索 Apple Music 中的歌曲。
• 参数: query (字符串) - 搜索查询文本
• 返回: 包含歌曲详细信息（标题、艺术家、专辑、时长和 URL）的数组
• generatePlaybackLink: 生成歌曲或播放列表的深度链接。
• 参数: song_id 或 playlist_id 必须提供其中一个
• 返回: 包含 Apple Music URL 的对象

常见问题解答

• 需要 Apple Developer 账户和 Apple Music API 访问权限
• 需要提供 Apple Music API Key (.p8 文件)

使用教程

使用依赖

• Rust (nightly, 因为使用了 rmcp)
• Apple Developer 账户，具有 Apple Music API 访问权限
• Apple Music API Key (.p8 文件)

安装教程

# 构建项目
cargo install --path .

调试方式

运行服务器时需要提供认证凭证：

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

命令行参数

Usage: applemusic-mcp-server [OPTIONS]

Options:
--team-id <TEAM_ID>                    Apple Developer Team ID
--key-id <KEY_ID>                      Apple Music Key ID
--private-key-path <PRIVATE_KEY_PATH>  Path to the Apple Music private key file (.p8)
--storefront <STOREFRONT>              Storefront for Apple Music (e.g. us, jp) [default: jp]
-h, --help                                 Print help
-V, --version                              Print version

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。