MCP Applemusic

🚀 MCP-AppleMusic

MCP-AppleMusic 是一個快速的 MCP 服務器實現方案，它能借助 AppleScript 命令，對 macOS 系統上的 Apple Music（曾用名 iTunes）進行便捷控制，為音樂管理帶來高效體驗。

🚀 快速開始

MCP-AppleMusic 可通過 AppleScript 命令控制 macOS 上的 Apple Music。使用前，需確保滿足特定的環境要求，並完成相應的安裝步驟。

✨ 主要特性

• 支持多種操作命令，如播放、暫停、切換曲目、搜索曲目、創建播放列表等。
• 藉助 MCP 服務器實現對 Apple Music 的快速控制。

📦 安裝指南

安裝依賴

首先確保已安裝 uv：

$ brew install uv

配置 Claude Desktop

使用 Claude Desktop，在 claude_desktop_config.json 中添加以下內容：

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

💻 使用示例

基礎用法

啟動服務器：

python server.py

高級用法

示例交互：

# 搜索歌曲
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 文件。

⚠️ 重要提示

• 該工具僅在 macOS 系統上有效，由於其 AppleScript 依賴。
• 需要安裝 Apple Music（以前稱為 iTunes）。