Skip to main content
Glama

MCP-AppleMusic

一个 FastMCP 服务器实现,用于通过 AppleScript 命令控制 macOS 上的 Apple Music(以前称为 iTunes)。

要求

  • Python 3.13+

  • 安装了 Apple Music App 的 macOS

  • MCP 库≥1.2.1

Related MCP server: MCP Browser Tabs Server

安装

首先,确保您已安装 uv:

$ brew install uv

然后,使用Claude Desktop ,将以下内容添加到claude_desktop_config.json

{ "mcpServers": { "iTunesControlServer": { "command": "uvx", "args": ["-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. 分叉存储库

  2. 创建你的功能分支( git checkout -b feature/amazing-feature

  3. 提交您的更改( git commit -m 'Add amazing feature'

  4. 推送到分支( git push origin feature/amazing-feature

  5. 打开拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。

笔记

  • 由于依赖 AppleScript,此工具仅适用于 macOS 系统

  • 需要安装 Apple Music(以前称为 iTunes)

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kennethreitz/mcp-applemusic'

If you have feedback or need assistance with the MCP directory API, please join our Discord server