applemusic-mcp-server

applemusic-mcp-server

1
entertainment_and_media

This project is a Model Context Protocol (MCP) server designed to interact with the Apple Music API. It offers features like searching for music and generating playback links using a command-line interface.

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 or playlist_id must be provided

Returns:

  • Object containing the Apple Music URL