Skip to main content
Glama
Sign In
enesjakozh

MCP-AppleMusic

by kennethreitz
Verified
GitHub
Python
26
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables control of Apple Music on macOS through AppleScript commands, including playback control, library search, song selection, and playlist creation.

  • Provides legacy support for controlling iTunes through AppleScript commands, offering functionality for playback control, library management, searching, and playlist creation.

  • Leverages macOS-specific AppleScript capabilities to enable music playback control and library management for Apple Music/iTunes applications.

MCP-AppleMusic

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

要求

  • Python 3.13+
  • 安装了 Apple Music App 的 macOS
  • MCP 库≥1.2.1

安装

首先，确保您已安装 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）

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

通过 MCP 命令通过 AppleScript 控制 macOS 上的 Apple Music，让用户可以管理播放、搜索曲目和创建播放列表。

  1. Requirements
    1. Installation
      1. Available Commands
        1. Usage
          1. Development
            1. Contributing
              1. License
                1. Notes

                  Related Resources

                  Appeared in Searches

                  ID: 5tfuto5q19