金大哥 - applemusic-mcp-server MCP 详情

article

README

🚀 苹果音乐 MCP 服务器

苹果音乐 MCP 服务器是一个强大的工具，用于与苹果音乐 API 进行交互。它提供了丰富的功能，如搜索歌曲、生成播放链接等，为用户带来便捷的音乐体验。

🚀 快速开始

要使用该服务器，你需要进行身份验证，通过命令行参数提供凭据以访问苹果音乐 API。以下是具体命令：

cargo run -- --team-id 您的团队 ID --key-id 您的密钥 ID --private-key-path /路径/到/AuthKey.p8

✨ 主要特性

🔍 精准搜索：可按歌曲标题、艺术家或专辑名称精准搜索歌曲。
🔗 深层链接生成：能为歌曲和歌单生成深层链接。
💻 简单命令行界面：操作方便，易于上手。
🤝 MCP 交互：使用模型上下文协议（MCP）与客户端进行交互。

📦 安装指南

# 构建项目
cargo install --path .

💻 使用示例

基础用法

该苹果音乐 MCP 服务器需要身份验证凭据才能访问苹果音乐 API。这些信息通过命令行参数提供。

cargo run -- --team-id 您的团队 ID --key-id 您的密钥 ID --private-key-path /路径/到/AuthKey.p8

命令行参数说明

使用方法: applemusic-mcp-server [选项]

选项:
--team-id <TEAM_ID>                    苹果开发者团队 ID
--key-id <KEY_ID>                      苹果音乐密钥 ID
--private-key-path <PRIVATE_KEY_PATH>  苹果音乐私有密钥文件路径（.p8 格式）
--storefront <STOREFRONT>              苹果音乐商店区域代码（例如 us, jp）[默认: jp]
-h, --help                                 显示帮助信息
-V, --version                              显示版本信息

📚 详细文档

API 工具

searchSongs

根据标题、专辑名称或艺术家名称从苹果音乐中搜索歌曲。

参数：
- query: (字符串) - 搜索文本
返回：
- 包含歌曲详细信息的 Song 对象数组，包括标题、艺术家、专辑、时长和 URL

generatePlaybackLink

生成播放歌曲或歌单的深层链接。

参数：
- 必须提供 song_id 或 playlist_id
返回：
- 包含苹果音乐 URL 的对象

🔧 技术细节

开发语言：Rust（nightly 版本，因为依赖 rmcp）
账户要求：需要具有苹果音乐 API 访问权限的苹果开发者账户
密钥要求：需要苹果音乐 API 密钥（.p8 文件）

applemusic-mcp-server