🚀 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）。