https://github.com/akr4/applemusic-mcp-server
https://github.com/akr4/applemusic-mcp-server
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/akr4/applemusic-mcp-server
- Owner: akr4
- License: mit
- Created: 2025-04-03T03:52:24.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-04-03T03:55:51.000Z (8 months ago)
- Last Synced: 2025-04-03T04:28:50.983Z (8 months ago)
- Language: Rust
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **applemusic-mcp-server** - An MCP server for interacting with the Apple Music API. `rust` `mcp` `server` `api` `cargo install --git https://github.com/akr4/applemusic-mcp-server` (🔧 Utilities)
README
# 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
```bash
# 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.
```bash
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 Apple Developer Team ID
--key-id Apple Music Key ID
--private-key-path Path to the Apple Music private key file (.p8)
--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