MCP-AppleMusic

by kennethreitz
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables control of Apple Music on macOS through AppleScript commands, including playback control, library search, song selection, and playlist creation.

  • Provides legacy support for controlling iTunes through AppleScript commands, offering functionality for playback control, library management, searching, and playlist creation.

  • Leverages macOS-specific AppleScript capabilities to enable music playback control and library management for Apple Music/iTunes applications.

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": ["-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
  1. 開発依存関係をインストールします。
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 ファイルを参照してください。

注記

  • このツールはAppleScriptに依存しているため、macOSシステムでのみ動作します。
  • Apple Music(旧iTunes)のインストールが必要です
-
security - not tested
F
license - not found
-
quality - not tested

MCP コマンドを通じて AppleScript 経由で macOS 上の Apple Music を制御しやすくし、ユーザーが再生を管理したり、トラックを検索したり、プレイリストを作成したりできるようにします。

  1. Requirements
    1. Installation
      1. Available Commands
        1. Usage
          1. Development
            1. Contributing
              1. License
                1. Notes
                  ID: 5tfuto5q19