MCP-AppleMusic

MCP-AppleMusic

AppleScript コマンドを使用して macOS 上の Apple Music（旧 iTunes）を操作する FastMCP サーバーの実装です。

要件

• Python 3.13+
• Apple Music アプリがインストールされた macOS
• MCP ライブラリ ≥1.2.1

インストール

まず、uv がインストールされていることを確認してください：

$ brew install uv

次に、Claude Desktop で以下を claude_desktop_config.json に追加してください：

{
  "mcpServers": {
    "iTunesControlServer": {
      "command": "uvx",
      "args": ["-p", "3.13", "-n", "mcp-applemusic"]
    }
  }
}

利用可能なコマンド

以下のコマンドを MCP サーバー経由で利用できます：

itunes_play()         # Start playback
itunes_pause()        # Pause playback
itunes_next()         # Skip to next track
itunes_previous()     # Go to previous track
itunes_search(query)  # Search library for tracks
itunes_play_song(song)  # Play specific song
itunes_create_playlist(name, songs)  # Create new playlist
itunes_library()      # Get library statistics

使用方法

サーバーを起動します：

python server.py

操作例：

# Search for a song
results = itunes_search("Hey Jude")

# Create a new playlist
itunes_create_playlist("Beatles Favorites", ["Yesterday", "Hey Jude", "Let It Be"])

# Play a specific song
itunes_play_song("Hey Jude")

開発

1. リポジトリをクローンします：

git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic

2. 開発用の依存関係をインストールします：

pip install -e ".[dev]"

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については LICENSE ファイルを参照してください。

注意事項

• このツールは AppleScript に依存しているため、macOS システムでのみ動作します
• Apple Music（旧 iTunes）がインストールされている必要があります