使用说明

项目简介

MCP-AppleMusic 是一个基于 Model Context Protocol (MCP) 的服务器实现，它允许大型语言模型 (LLM) 通过 MCP 协议控制 macOS 系统上的 Apple Music 应用程序（前身为 iTunes）。该服务器通过 AppleScript 命令与 Apple Music 进行交互，为 LLM 客户端提供了一系列工具，用于音乐播放控制、库搜索和播放列表管理等功能。

主要功能点

音乐播放控制: 支持播放、暂停、下一曲、上一曲等基本播放控制功能。
音乐搜索: 允许 LLM 搜索 Apple Music 音乐库，查找特定歌曲。
歌曲播放: 可以指定歌曲名称播放音乐库中的歌曲。
播放列表管理: 支持创建新的播放列表，并将歌曲添加到指定播放列表。
音乐库信息: 提供获取音乐库统计信息的功能，例如歌曲总数和播放列表总数。

安装步骤

安装 uv: 确保你的 macOS 系统上安装了 uv 包管理器。如果没有安装，请使用以下命令安装：
```
brew install uv
```
安装 MCP-AppleMusic 服务器: 按照仓库 README.md 提供的步骤进行安装，通常包括克隆仓库和安装依赖。请参考仓库的详细安装指南。

服务器配置

要将 MCP-AppleMusic 服务器与 MCP 客户端（例如 Claude Desktop）连接，您需要在客户端的配置文件中添加服务器配置信息。对于 Claude Desktop，您需要编辑 'claude_desktop_config.json' 文件，并在 'mcpServers' 字段下添加以下 JSON 配置：

{
  "mcpServers": {
    "iTunesControlServer": {  // 服务器名称，可以自定义
      "command": "uvx",      // 启动服务器的命令，这里使用 uvx
      "args": ["-n", "mcp-applemusic"] // 命令参数，-n mcp-applemusic  可能是指定 uv 环境的名称，具体请参考项目文档
    }
  }
}

基本使用方法

启动服务器: 在 MCP-AppleMusic 服务器的根目录下，运行以下命令启动服务器：
```
python server.py
```
或者根据仓库的 'README.md' 文件中 "Usage" 部分的指示进行操作。
客户端调用: 配置完成后，您的 MCP 客户端（如 Claude Desktop）应该能够检测到并连接到 iTunesControlServer。您可以使用客户端提供的界面或 API 调用服务器提供的工具，例如 'itunes_search("歌曲名")' 来搜索歌曲，或 'itunes_play_song("歌曲名")' 来播放特定歌曲。具体可用的命令请参考 "Available Commands" 部分。

注意: 该服务器依赖 macOS 系统和 Apple Music 应用程序，并且需要安装 Python 3.13+ 和 MCP library ≥1.2.1。

关键词