mcpField
M
MCP-AppleMusic

MCP-AppleMusic

本地服务
github.com/kennethreitz游戏娱乐9159 周前更新

关于 MCP-AppleMusic

MCP-AppleMusic 是一个实验性的 MCP 服务,通过 AppleScript 在 macOS 上控制 Apple Music。适合希望用 AI 助手管理播放与资料库的 macOS 用户。

主要功能

  1. 01播放、暂停与切换曲目
  2. 02按名称搜索资料库曲目
  3. 03播放指定歌曲
  4. 04创建播放列表
  5. 05获取资料库统计信息

适用场景

  1. 01用自然语言控制 Apple Music 播放
  2. 02按歌名搜索并播放资料库中的歌曲
  3. 03创建主题播放列表

MCP 相关

该项目是 MCP 服务,向 MCP 客户端暴露 itunes_play、itunes_search、itunes_create_playlist 等工具,用于控制 Apple Music。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

MseeP.ai 安全评估徽章

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")

开发

  1. 克隆仓库:
git clone https://github.com/yourusername/mcp-applemusic.git
cd mcp-applemusic
  1. 安装开发依赖项:
pip install -e ".[dev]"

贡献

  1. Fork 仓库
  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 文件。

注意事项

  • 由于依赖 AppleScript,此工具仅适用于 macOS 系统
  • 需要安装 Apple Music(原 iTunes)

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。