
cifero74/mcp-apple-music
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP를 통해 Claude에 대한 전체 Apple Music 통합 - 검색 카탈로그, 라이브러리 및 재생 목록을 관리
개요
mcp 이름: io.github.Cifero74/mcp-apple-music Apple Music 계정에 Claude 전체 액세스 권한을 부여하는 것은 카탈로그를 검색하고 개인 도서관을 검색하고 재생 목록을 관리하고 청취 역사와 권고를 탐구합니다. - "나는 늦게 듣는 것에 기초를 두어, 내가 아직 가지고 있지 않은 15 곡을 추천하고 새로운 플레이리스트에 추가" - "내 모든 재생 목록을 표시하고 대부분의 예술가가 나타날 것을 말해" - "닉 동굴에 의해 앨범을 검색하고 어두운 Picks라는 재생 목록에 내 세 가지 즐겨 찾기를 추가" - Python 3.10+ - uv (recommended) 또는 pip - MusicKit 키가있는 (무료 계층은 괜찮습니다) - 활성 1. 개발자로 이동.apple.com → 2. 아래, 새로운 키를 만들려면 클릭 3. 어떤 이름, 활성화, 클릭 4. .p8 파일 - 당신은 단지 그것을 한 번 다운로드 할 수, 안전 유지! 5. 참고 (예 : ABC123DEF4) 및 (회원 정보 아래) ⚠️ 키 ID는 키 이름 옆에 표시된 알파벳 코드입니다. - .p8 파일의 파일명.
개요(AI 번역)
mcp 이름: io.github.Cifero74/mcp-apple-music
MCP (Model Context Protocol) 서버는 Apple Music 계정에 Claude 전체 액세스 권한을 부여하고 개인 라이브러리를 검색하고 재생 목록을 관리하고 청취 역사와 권고를 탐구합니다.
Ask Claude 같은 것들:
- “나는 늦게 듣는 것에 기초를 두어, 내가 아직 가지고 있지 않은 15 곡을 추천하고 새로운 재생 목록에 추가”*
- “내 모든 재생 목록을 표시하고 아티스트가 가장 많이 나타낸다”
- “Nick Cave의 앨범 검색 및 어두운 Picks”*라는 재생 목록에 내 3 개의 즐겨찾기 추가
특징
| 도구 | 설명 |
|—|||
| search_catalog | 검색 애플 음악 카탈로그(송, 앨범, 아티스트, 재생목록) |
| search_library | 개인 도서관 내 검색 |
| get_library_songs | 라이브러리에 저장된 곡 일람 |
| get_library_albums | 라이브러리의 앨범 일람 |
| [T4] | 라이브러리의 아티스트 일람 |
| [T5] | 아이디와 함께하는 모든 재생 목록 |
| get_playlist_tracks | 플레이리스트 중 하나나 Apple Music 카탈로그 재생 목록([T7]] 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
.p8file — 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
.p8file.
2. Clone and install
git clone https://github.com/Cifero74/mcp-apple-music
cd mcp-apple-music
# with uv (recommended)
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"apple-music": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/mcp-apple-music",
"mcp-apple-music"
]
}
}
}