JinDaGe - mcp-applemusic MCP Details

article

README

🚀 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()      # 获取库统计信息

开发步骤

克隆仓库：

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

安装开发依赖项：

pip install -e ".[dev]"

贡献指南

叉克隆仓库
创建功能分支（git checkout -b feature/amazing-feature）
提交更改（git commit -m 'Add amazing feature'）
推送到分支（git push origin feature/amazing-feature）
打开 Pull Request

📄 许可证

此项目根据 MIT 许可证发布，详情请参阅 LICENSE 文件。

⚠️ 重要提示

该工具仅在 macOS 系统上有效，由于其 AppleScript 依赖。
需要安装 Apple Music（以前称为 iTunes）。

mcp-applemusic