MCP-AppleMusic
AppleScript コマンドを使用して macOS 上の Apple Music (旧 iTunes) を制御するための FastMCP サーバー実装。
要件
- Python 3.13以上
- Apple MusicアプリがインストールされたmacOS
- MCPライブラリ ≥1.2.1
インストール
まず、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
使用法
サーバーを起動します。
やり取りの例:
# 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")
発達
- リポジトリをクローンします。
git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic
- 開発依存関係をインストールします。
貢献
- リポジトリをフォークする
- 機能ブランチを作成します(
git checkout -b feature/amazing-feature
) - 変更をコミットします(
git commit -m 'Add amazing feature'
) - ブランチにプッシュする (
git push origin feature/amazing-feature
) - プルリクエストを開く
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
注記
- このツールはAppleScriptに依存しているため、macOSシステムでのみ動作します。
- Apple Music(旧iTunes)のインストールが必要です