Skip to main content
Glama
deenesjakoruzh
saitarrun

apple_music_mcp

by saitarrun
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Apple Music MCP

Apple Music을 위한 고성능 Model Context Protocol(MCP) 서버. 네이티브 macOS JXA 및 클라우드 REST 엔진을 겸비하여, 크로스 플랫폼 검색, 비동기 일괄 처리, 제로 타임아웃 실행을 지원합니다.

⚡ 빠른 시작

npx 또는 **uvx**로 즉시 실행하세요 (설치 불필요):

옵션 A: npx 사용 (권장)

npx -y @saitarrunpitta/apple-music-mcp

옵션 B: uvx 사용

uvx --from git+https://github.com/saitarrun/apple-music-mcp.git apple-music-mcp serve

옵션 C: npm 또는 pip로 로컬 설치

npm install -g @saitarrunpitta/apple-music-mcp
# or
pip install git+https://github.com/saitarrun/apple-music-mcp.git

Related MCP server: apple-music-mcp

🔌 MCP 클라이언트 설정

apple-music을 선호하는 AI 어시스턴트에 몇 초 만에 추가하세요:

1. Antigravity / AGY CLI

agy mcp add apple-music -- npx -y @saitarrunpitta/apple-music-mcp

2. Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "apple-music": {
      "command": "npx",
      "args": [
        "-y",
        "@saitarrunpitta/apple-music-mcp"
      ]
    }
  }
}

3. Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "apple-music": {
      "command": "npx",
      "args": [
        "-y",
        "@saitarrunpitta/apple-music-mcp"
      ]
    }
  }
}

4. Codex MCP

codex mcp add apple-music -- npx -y @saitarrunpitta/apple-music-mcp

✨ 한눈에 보는 기능

  • ⚡ 제로 타임아웃 JXA 엔진: AppleScript 동결 없이 1,000곡 이상의 플레이리스트를 100ms 이내에 읽습니다.

  • 🌐 크로스 플랫폼 차트: Shazam, Spotify, YouTube, Apple Music에서 직접 검색 피드를 제공합니다.

  • 🚀 비동기 병렬 일괄 처리: 100곡 이상을 병렬로 추가하거나 제거하며 1초 이내에 처리합니다.

  • 🎵 순수 오디오 강제 적용: 뮤직 비디오와 가사 비디오를 자동으로 필터링하여 플레이리스트를 순수 오디오로 유지합니다.

  • 🛡️ 100% 중복 방지: 내장된 퍼지 매칭으로 중복 곡 추가를 방지합니다.

  • 🔐 자동 Safari 인증: 수동 API 키 없이 Safari에서 웹 플레이어 토큰을 원활하게 추출합니다.

  • 🧠 스마트 추천: 청취 기록 및 아티스트 유사성을 기반으로 실시간 트랙을 추천합니다.

🛠️ 도구 참조

카테고리

도구

설명

탐색

apple_music_get_cross_platform_charts

Shazam, Spotify, YouTube, Apple Music 차트에서 인기 곡을 가져옵니다.

apple_music_populate_from_charts

중복 제거와 함께 모든 차트에서 플레이리스트를 바로 채웁니다.

apple_music_get_music_recommendations

청취 기록 및 아티스트 기반 스마트 추천.

apple_music_get_recently_played

Apple Music 클라우드에서 최근 청취 기록을 가져옵니다.

apple_music_get_heavy_rotation

가장 많이 재생된 앨범과 플레이리스트를 가져옵니다.

플레이리스트

apple_music_list_playlists

보관함의 모든 플레이리스트와 트랙 수, 설명을 나열합니다.

apple_music_get_playlist_tracks

트랙 제목, 아티스트, 앨범, 재생 시간을 빠르게 대량 조회합니다.

apple_music_add_tracks_to_playlist

중복 없이 병렬 일괄 추가.

apple_music_remove_tracks_from_playlist

트랙 관계 ID를 일괄 제거합니다.

apple_music_create_playlist

사용자 지정 설명으로 새 플레이리스트를 만듭니다.

apple_music_delete_playlist

보관함에서 노래를 삭제하지 않고 플레이리스트만 안전하게 삭제합니다.

apple_music_set_playlist_description

플레이리스트 설명을 업데이트하고 iCloud에 동기화합니다.

카탈로그

apple_music_search_catalog

글로벌 Apple Music 카탈로그를 검색합니다 (노래, 앨범, 아티스트, 플레이리스트).

apple_music_resolve_song

제목/아티스트에 해당하는 정확한 스튜디오 오디오 카탈로그 ID를 찾습니다.

apple_music_get_artist_top_songs

모든 아티스트의 인기 곡을 가져옵니다.

apple_music_get_catalog_playlist_tracks

Apple 공식 큐레이션 플레이리스트(pl.xxx)에서 트랙을 가져옵니다.

재생

apple_music_playback_control

플레이어를 제어합니다 (play, pause, skip, volume, shuffle, rate, love).

apple_music_airplay_devices

사용 가능한 AirPlay 스피커와 HomePod를 발견합니다.

큐레이션

apple_music_curation_clean_videos

비디오 항목을 제거하고 공식 스튜디오 오디오 곡으로 교체합니다.

apple_music_curation_deduplicate

플레이리스트 에디션의 중복을 제거하고 정식 트랙을 유지합니다.

apple_music_curation_merge_playlists

100% 중복 제거로 플레이리스트를 병합합니다.

💻 CLI 명령어

# Check status & active tokens
apple-music-mcp status

# Extract authentication tokens from open Safari session
apple-music-mcp login

# Clear catalog cache
apple-music-mcp clean-cache

# Run MCP server over stdio
apple-music-mcp serve

🏷️ 태그 & 검색 가능성

#ModelContextProtocol #MCP #MCPServer #AppleMusic #ClaudeAI #CursorAI #AnthropicClaude #AIAgents #MusicKit #Spotify #Shazam #YouTubeMusic #AppleScript #Python #OpenSource #DeveloperTools #LLM #Automation #PlaylistGenerator

📄 라이선스

MIT © saitarrun

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/saitarrun/apple-music-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server