mcp苹果音乐🎵
  
一 MCP（模型上下文协议）服务器 这使Claude可以完全访问您的Apple Music帐户——搜索目录、浏览个人库、管理播放列表以及浏览您的收听历史和推荐。
问克劳德这样的问题： - *“根据我最近听的内容，推荐15首我还没有的歌曲，并将其添加到新的播放列表中”* - *“显示我的所有播放列表，并告诉我哪些艺术家出现得最多”* - *“搜索Nick Cave的专辑，并将我的三个收藏夹添加到名为Dark Picks的播放列表中”*
______________________________________________________________________
特性
| 工具 | 说明 |
|---|---|
search_catalog | 搜索Apple Music目录（歌曲、专辑、艺术家、播放列表） |
search_library | 在您的个人图书馆中搜索 |
get_library_songs | 列出保存在曲库中的歌曲（分页） |
get_library_albums | 列出库中的相册（分页） |
get_library_artists | 列出库中的艺术家 |
get_library_playlists | 列出所有带有ID的播放列表 |
get_playlist_tracks | 获取特定播放列表中的曲目 |
create_playlist | 创建新的播放列表 |
add_tracks_to_playlist | 将歌曲添加到播放列表（库或目录曲目） |
get_recently_played | 查看最近播放的专辑/播放列表/电台 |
get_recommendations | 获取个性化的Apple Music精选 |
______________________________________________________________________
需求
- Python 3.10+
- 紫外线 （推荐）或pip
- 一 Apple开发者帐户 （免费版也可以）带MusicKit密钥
- 活跃 Apple Music订阅
______________________________________________________________________
设置
1.创建MusicKit密钥
- 首选 developer.apple.com → 证书、标识符和配置文件
- 在...之下 钥匙，单击 + 创建新密钥
- 给它起个名字，启用 音乐套件，然后单击 继续→ 注册
- 下载 这
.p8文件——你只能下载一次，保证安全！ - 注意你的 密钥ID （例如。
ABC123DEF4)和你的 团队编号 （发现于 *会员详细信息*)
⚠️ 密钥ID是密钥名称旁边显示的字母数字代码-- 不 的文件名 .p8 文件。2.克隆并安装
git clone https://github.com/marioinghilleri/mcp-apple-music
cd mcp-apple-music
# with uv (recommended)
uv sync
# or with pip
pip install -e .3.运行一次性安装向导
# with uv
uv run mcp-apple-music-setup
# or directly
python -m mcp_apple_music.setup向导将要求您 团队编号, 密钥ID，以及通往你的道路 .p8 文件。然后，它会打开一个浏览器页面，您可以在其中单击 “授权Apple Music” --这使用苹果官方的MusicKit JS来获取您的音乐用户令牌，该令牌安全地存储在 ~/.config/mcp-apple-music/config.json （文件权限： 600).
4.添加到克劳德桌面
打开您的Claude桌面配置：
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"apple-music": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/mcp-apple-music",
"mcp-apple-music"
]
}
}
}重新启动Claude Desktop——您应该在工具栏中看到可用的苹果音乐工具。
______________________________________________________________________
运作原理
Apple Music需要两个单独的令牌：
- 开发者令牌 --您在本地使用您的JWT签名
.p8私钥。有效期长达6个月；服务器会在到期前自动重新生成它。你的钥匙永远不会离开你的机器。 - 音乐用户令牌 --通过浏览器中的MusicKit JS OAuth获得一次（安装向导处理此操作）。存储在本地
~/.config/mcp-apple-music/config.json.
Your .p8 key ──► Developer Token (JWT, auto-renewed) ─┐
├──► Apple Music API
Browser OAuth ──► Music User Token (stored locally) ─┘⚠️ 播放控制 （播放/暂停/跳过）无法通过Apple的REST API使用。它需要在浏览器上下文中运行本机MusicKit框架（iOS/macOS应用程序）或MusicKit JS。
______________________________________________________________________
项目结构
mcp-apple-music/
├── src/
│ └── mcp_apple_music/
│ ├── __init__.py
│ ├── auth.py — Developer Token generation + User Token management
│ ├── client.py — Async HTTP client for api.music.apple.com
│ ├── server.py — FastMCP server with all 11 tools
│ └── setup.py — One-time setup wizard (browser-based OAuth)
├── config.example.json — Example config structure (no secrets)
├── pyproject.toml
└── README.md______________________________________________________________________
示例提示
连接后，您可以问Claude：
"What have I been listening to this week? Based on that, find 10 songs
I don't own yet that I'd probably enjoy and create a playlist with them."
"Search for all albums by Joni Mitchell and tell me which ones
I already have in my library."
"List my playlists, pick the one that looks most like a workout mix,
and add 5 high-energy songs from the catalog to it."
"Create a playlist called 'Rainy Sunday' with the 10 most mellow tracks
you can find from my library."______________________________________________________________________
作者
该项目的构思、设计、调试和交付完全通过Mario和Claude之间的合作对话进行——从API研究和授权流设计，通过设置向导，到使用真正的Apple Music库进行现场测试。
欢迎投稿、投稿和PR！
______________________________________________________________________
许可证
麻省理工学院 --用它，叉它，在它上面建造。