关于 MCP-AppleMusic
MCP-AppleMusic 是一个实验性的 MCP 服务,通过 AppleScript 在 macOS 上控制 Apple Music。适合希望用 AI 助手管理播放与资料库的 macOS 用户。
主要功能
- 01播放、暂停与切换曲目
- 02按名称搜索资料库曲目
- 03播放指定歌曲
- 04创建播放列表
- 05获取资料库统计信息
适用场景
- 01用自然语言控制 Apple Music 播放
- 02按歌名搜索并播放资料库中的歌曲
- 03创建主题播放列表
MCP 相关
该项目是 MCP 服务,向 MCP 客户端暴露 itunes_play、itunes_search、itunes_create_playlist 等工具,用于控制 Apple Music。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
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": ["-p", "3.13", "-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")
开发
- 克隆仓库:
git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic
- 安装开发依赖项:
pip install -e ".[dev]"
贡献
- Fork 仓库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交更改(
git commit -m 'Add amazing feature') - 将更改推送到分支(
git push origin feature/amazing-feature) - 创建 Pull Request
许可证
本项目采用 MIT 许可证授权,详情请参阅 LICENSE 文件。
注意事项
- 由于依赖 AppleScript,此工具仅适用于 macOS 系统
- 需要安装 Apple Music(原 iTunes)
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
