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からWebプレイヤートークンをシームレスに抽出します。

  • 🧠 スマートレコメンデーション: 再生履歴とアーティスト類似性に基づいたリアルタイムのトラック提案。

🛠️ ツールリファレンス

カテゴリ

ツール

説明

ディスカバリー

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