cifero74/mcp-apple-music

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

44 stars 10 forks 质量 80 趋势 32MIT

Repository Install

通过MCP实现Claude的完整Apple Music集成——搜索目录，管理库和播放列表

概览

mcp-name： io.github.Cifero74/mcp-apple-music 这让Claude可以完全访问你的Apple Music账户——搜索目录、浏览个人音乐库、管理播放列表，并探索你的听歌历史和推荐。 - “根据我最近听的歌曲，推荐15首我还没有的歌曲，并添加到新的播放列表” - “给我看我所有播放列表，告诉我哪些艺术家出现得最多” - “搜索Nick Cave的专辑，并将我的三首最爱添加到名为Dark Picks的播放列表” - Python 3.10+ - uv（推荐）或 pip - an（免费方案即可），搭配 MusicKit 密钥 - 一个主动键 1. 前往 developer.apple.com → 2.在，下，点击创建新密钥 3.给它任意名称，启用，然后点击 4..p8 文件——你只能下载一次，请妥善保管！5. 记录你的（例如：ABC123DEF4）和你的（在会员详情中找到） ⚠️ 密钥ID是显示在键名旁边的字母数字代码——.p8文件的文件名。

概述（AI 翻译）

mcp-name： io.github.Cifero74/mcp-apple-music

一个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`	将曲目放入你的播放列表或Apple Music目录播放列表（`pl.` ID）中

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

mcp-apple-music 🎵

mcp-name: io.github.Cifero74/mcp-apple-music

An MCP (Model Context Protocol) server that gives Claude full access to your Apple Music account — search the catalog, browse your personal library, manage playlists, and explore your listening history and recommendations.

Ask Claude things like:

“Based on what I’ve been listening to lately, recommend 15 songs I don’t have yet and add them to a new playlist”

“Show me all my playlists and tell me which artists appear most”

“Search for albums by Nick Cave and add my three favourites to a playlist called Dark Picks”

Features

Tool	Description
`search_catalog`	Search Apple Music catalog (songs, albums, artists, playlists)
`search_library`	Search within your personal library
`get_library_songs`	List songs saved in your library (paginated)
`get_library_albums`	List albums in your library (paginated)
`get_library_artists`	List artists in your library
`get_library_playlists`	List all your playlists with IDs
`get_playlist_tracks`	Get tracks inside one of your playlists or an Apple Music catalog playlist (`pl.` IDs)
`create_playlist`	Create a new playlist
`add_tracks_to_playlist`	Add songs to a playlist (library or catalog tracks)
`add_to_library`	Save catalog songs, albums or playlists into your library
`get_recently_played`	See recently played albums/playlists/stations
`get_recommendations`	Get personalised Apple Music picks
`favorite_song`	Mark a catalog song as favorite (star)
`unfavorite_song`	Remove a catalog song from favorites
`get_song_favorite_status`	Check which catalog songs are favorited

Requirements

Python 3.10+
uv (recommended) or pip
A paid Apple Developer Program membership (99 USD/year) to create a MusicKit key. The free Apple Developer account can’t create MusicKit keys.
An active Apple Music subscription

Setup

1. Create a MusicKit Key

Go to developer.apple.com → Certificates, Identifiers & Profiles
Under Keys, click + to create a new key
Give it any name, enable MusicKit, and click Continue → Register
Download the .p8 file — you can only download it once, keep it safe!
Note your Key ID (e.g. ABC123DEF4) and your Team ID (found under Membership Details)

⚠️ The Key ID is the alphanumeric code shown next to the key name — not the filename of the .p8 file.

2. Clone and install

git clone https://github.com/Cifero74/mcp-apple-music
cd mcp-apple-music

# with uv (recommended)

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "apple-music": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/mcp-apple-music",
        "mcp-apple-music"
      ]
    }
  }
}