Applemusic MCP Server

🚀 アップルミュージック MCP サーバー

このサーバーは、アップルミュージック API とのインタラクションを可能にする MCP サーバーです。曲の検索や再生リンクの生成などのツールを提供します。

✨ 主な機能

• 曲のタイトル、アーティスト、またはアルバム名で曲を検索
• 曲やプレイリストのディープリンクを生成
• シンプルなコマンドラインインターフェイス
• モデルコンテキストプロトコル（MCP）を使用してクライアントと通信

📦 インストール

# プロジェクトをビルド
cargo install --path .

💻 使用例

基本的な使用法

このアップルミュージック MCP サーバーは、アップルミュージック API にアクセスするために認証情報が必要です。これらの情報はコマンドライン引数で提供されます。

cargo run -- --team-id あなたのチーム ID --key-id あなたのキー ID --private-key-path /パス/へ/AuthKey.p8

コマンドライン引数

使用方法: applemusic-mcp-server [オプション]

オプション:
--team-id <TEAM_ID>                    アップル開発者チーム ID
--key-id <KEY_ID>                      アップルミュージックキー ID
--private-key-path <PRIVATE_KEY_PATH>  アップルミュージックの秘密鍵ファイルのパス（.p8 形式）
--storefront <STOREFRONT>              アップルミュージックのストアフロントコード（例: us, jp）[デフォルト: jp]
-h, --help                                 ヘルプ情報を表示
-V, --version                              バージョン情報を表示

📚 ドキュメント

searchSongs

タイトル、アルバム名、またはアーティスト名に基づいてアップルミュージックから曲を検索します。

パラメータ:

• query: (文字列) - 検索テキスト

戻り値:

• 曲の詳細情報（タイトル、アーティスト、アルバム、再生時間、URL を含む）を持つ Song オブジェクトの配列

generatePlaybackLink

曲またはプレイリストの再生用ディープリンクを生成します。

パラメータ:

• song_id または playlist_id のいずれかを指定する必要があります

戻り値:

• アップルミュージックの URL を含むオブジェクト

🔧 技術詳細

必要条件

• Rust（nightly バージョン、rmcp に依存するため）
• アップルミュージック API へのアクセス権を持つアップル開発者アカウント
• アップルミュージック API キー（.p8 ファイル）