Apple Music MCP Server
by akr4
An MCP server for interacting with the Apple Music API. It provides tools for searching songs and generating playback links.
View on GitHub
Last updated: N/A
Apple Music MCP Server
An MCP server for interacting with the Apple Music API. This server provides tools for searching songs, generating playback links.
Features
- Search for songs by title, artist, or album
- Generate deep links for songs and playlists
- Simple command-line interface
- Uses the Model Context Protocol (MCP) to interact with clients
Requirements
- Rust (nightly, because of rmcp)
- Apple Developer account with Apple Music API access
- Apple Music API Key (.p8 file)
Installation
# Build the project
cargo install --path .
Usage
The Apple Music MCP server requires authentication credentials to access the Apple Music API. These are provided via command-line arguments.
cargo run -- --team-id YOUR_TEAM_ID --key-id YOUR_KEY_ID --private-key-path /path/to/AuthKey.p8
Command-line Arguments
Usage: applemusic-mcp-server [OPTIONS]
Options:
--team-id <TEAM_ID> Apple Developer Team ID
--key-id <KEY_ID> Apple Music Key ID
--private-key-path <PRIVATE_KEY_PATH> Path to the Apple Music private key file (.p8)
--storefront <STOREFRONT> Storefront for Apple Music (e.g. us, jp) [default: jp]
-h, --help Print help
-V, --version Print version
API Tools
searchSongs
Search for songs from Apple Music by title, album name, or artist name.
Parameters:
query
: (string) - The search query text
Returns:
- Array of Song objects with details including title, artist, album, duration, and URLs
generatePlaybackLink
Generate a deep link for playback of a song or playlist.
Parameters:
- Either
song_id
orplaylist_id
must be provided
Returns:
- Object containing the Apple Music URL