MCP Applemusic

🚀 MCP-AppleMusic

このプロジェクトは、AppleScriptコマンドを通じてmacOS上のApple Music（旧称iTunes）を制御するための高速なMCPサーバー実装です。

🚀 クイックスタート

このMCP-AppleMusicを使用することで、macOS上のApple Musicを簡単に制御できます。以下の手順に従ってセットアップしましょう。

✨ 主な機能

• Apple Musicの再生、一時停止、次の曲、前の曲などの基本操作をサポート。
• 曲の検索、特定の曲の再生、新しいプレイリストの作成などの高度な操作が可能。

📦 インストール

前提条件

• Python 3.13+
• macOSにApple Musicアプリがインストールされていること
• MCPライブラリ ≥1.2.1

インストール手順

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

$ brew install uv

次に、Claude Desktopを使用して、claude_desktop_config.jsonに以下の内容を追加します。

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

💻 使用例

基本的な使用法

サーバーを起動します。

python server.py

高度な使用法

以下は、MCP-AppleMusicを使用した具体的な操作例です。

# 曲を検索する
results = itunes_search("Hey Jude")

# 新しいプレイリストを作成する
itunes_create_playlist("披头士最爱", ["Yesterday", "Hey Jude", "Let It Be"])

# 特定の曲を再生する
itunes_play_song("Hey Jude")

利用可能なコマンド

MCPサーバーを通じて利用可能なコマンドは以下の通りです。

itunes_play()         # 再生を開始する
itunes_pause()        # 再生を一時停止する
itunes_next()         # 次の曲にジャンプする
itunes_previous()     # 前の曲にジャンプする
itunes_search(query)  # ライブラリ内で曲を検索する
itunes_play_song(song)  # 特定の曲を再生する
itunes_create_playlist(name, songs)  # 新しいプレイリストを作成する
itunes_library()      # ライブラリの統計情報を取得する

📚 ドキュメント

開発手順

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. Pull Requestを開きます。

📄 ライセンス

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

注意事項

⚠️ 重要提示

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