Skip to main content
Glama
RicardoCA

Apple Music MCP Server

by RicardoCA

Apple Music MCP 서버 v2

Apple 개발자 계정 불필요! .p8 인증서, API 키, 개발자 계정이 필요하지 않습니다.

Apple ID만 사용하여 Claude Code를 Apple Music에 연결합니다.

작동 방식

MCP가 실제 브라우저(Chromium)를 열면, music.apple.com에서 Apple ID로 로그인하여 음악을 재생합니다. 그러면 Playwright가 Apple 사이트에서 생성하는 인증 토큰을 자동으로 캡처합니다. 아주 간단합니다.

Related MCP server: Spotify MCP Server

빠른 설정 (3단계)

1. 설치

cd apple-music-mcp
npm install
npx playwright install chromium
npm run build

2. 로그인 - 1단계

node dist/login.js

브라우저가 열립니다. Apple ID로 로그인하고 아무 음악이나 재생하세요. 토큰이 캡처되면 브라우저를 닫으세요.

2. 로그인 - 2단계

node atualizatokens.mjs

3. Claude Code 설정

MCP 설정 파일에 추가하세요:

{
  "mcpServers": {
    "apple-music": {
      "command": "node",
      "args": ["CAMINHO\\COMPLETO\\apple-music-mcp\\dist\\index.js"],
      "cwd": "CAMINHO\\COMPLETO\\apple-music-mcp"
    }
  }
}

Claude Code를 재시작하세요. 완료되었습니다!

사용 가능한 도구

도구

설명

apple_music_login

브라우저를 통한 로그인 (토큰 만료 시)

apple_music_status

로그인 상태 및 토큰 유효성 확인

get_recently_played

최근 재생한 음악

get_playlists

플레이리스트 목록

get_playlist_tracks

특정 플레이리스트의 음악

search_music

카탈로그 검색 (음악, 아티스트, 앨범)

get_recommendations

AI 기반 맞춤 추천

get_music_profile

취향에 대한 전체 프로필

get_top_artists

가장 많이 들은 아티스트

create_playlist

플레이리스트 생성 (수동 또는 추천 기반)

get_track_details

음악 상세 정보

Claude Code 예시

- "Quais sao minhas musicas recentes?"
- "Crie uma playlist com 30 recomendacoes de indie rock"
- "Me mostre meu perfil musical"
- "Busque por bossa nova e crie uma playlist 'Foco'"
- "Quais musicas estao na playlist 'Favoritas'?"
- "Quem sao meus top 10 artistas?"

참고 사항

  • 토큰은 약 25일간 유효합니다. 만료되면 node dist/login.js를 다시 실행하세요.

  • 처음 실행 시 Chromium 설치(~150MB)로 인해 시간이 다소 소요될 수 있습니다.

  • Windows, Mac, Linux에서 작동합니다.

  • 개인 데이터(기록, 플레이리스트)를 사용하려면 Apple Music 구독이 필요합니다.

  • 카탈로그 검색은 로그인 없이도 가능합니다(제한적).

Related MCP Connectors

Related MCP Servers