SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体mcp-applemusic

mcp-applemusic

mcp-applemusic 是一个运行于 macOS 的 FastMCP 服务器，让 AI 智能体可以控制 Apple Music。它提供 74 个工具，涵盖播放控制、播放列表管理、自主式无令牌 DJ 打碟、听歌分析、Spotify/M3U 歌单导入、智能 DJ 过渡与音频设备控制。主要功能包括：完整的 Apple Music 控制（播放、音量、按设备调节 AirPlay、EQ 预设、重复/随机模式、MiniPlayer）；收听日志与月度 Replay 报告（本地 SQLite 数据库加后台守护进程 scrobbler 持续追踪）；跨平台 Spotify 导入器，无需登录或令牌即可把公开 Spotify 歌单和专辑导入 Apple Music；智能 AI DJ 过渡（自动计算 BPM 并裁剪首尾偏移实现无缝交叉淡入淡出）；混合歌词与通用链接（通过 LRCLIB 即时获取歌词，生成 song.link 通用分享链接）；播放列表管理与导出（嵌套文件夹、去重、自动排序，可导出为 JSON、CSV 或 Markdown）。需在已安装 Apple Music 应用的 macOS 上运行，并需要 uv 包管理器。该服务器 100% 本地运行，通过标准 I/O（stdio）通信，所有播放命令、媒体库修改和收听历史均保存在本机，不存储或传输任何凭证、令牌或个人标识。采用 MIT 许可证。

访问官网

工具介绍

用途

mcp-applemusic 是一个为 macOS 打造的 FastMCP 服务器，用于让 AI 智能体（AI agent）控制本机的 Apple Music。它面向希望通过自然语言操作音乐播放、整理歌单和查看收听统计的用户，把 Apple Music 的多种操作封装为 74 个可供 AI 调用的工具。

主要能力

  • 完整的 Apple Music 控制：支持播放、音量调节、按设备调节 AirPlay 电平、EQ 预设、重复/随机模式以及 MiniPlayer。
  • 收听日志与月度 Replay：使用本地 SQLite 数据库和后台守护进程 scrobbler 持续追踪收听记录，并可生成 Apple Replay 报告。
  • 跨平台 Spotify 导入器：可将公开的 Spotify 歌单和专辑直接导入 Apple Music，无需登录或令牌。
  • 智能 AI DJ 过渡：自动计算 BPM，并裁剪起始/结束偏移，实现连续无缝的交叉淡入淡出。
  • 混合歌词与通用链接：通过 LRCLIB 即时获取歌词，并生成 song.link 通用链接，便于在 Spotify/YouTube/Tidal 之间分享歌曲。
  • 播放列表管理与导出：支持嵌套文件夹、去重、自动排序，并可导出为 JSON、CSV 或 Markdown。

使用方式

运行环境要求：

  • 已安装 Apple Music 应用的 macOS。
  • uv 包管理器（可通过 brew install uv 安装）。

配置方式包括：

  • 方式一：通过 Smithery 一键自动安装（用于 Claude Desktop 的自动安装与配置）。
  • 方式二：Claude Desktop：在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加配置。
  • 方式三：Cursor / Windsurf / VS Code：在 MCP 设置（.cursor/mcp.json 或 Cline/Roo 设置）中添加配置；也可通过 Git URL 配置，例如 "args": ["git+https://github.com/suleyman416/mcp-applemusic.git"]。

权限说明：首次运行时，macOS 会请求 AI 客户端或终端控制 Music.app 的权限。请点击允许，或前往系统设置 ➔ 隐私与安全性 ➔ 自动化 中确认。

连接后可用自然语言向 AI 智能体下达指令，例如：

  • 播放与音频：“Play Location by Dave”“Set volume to 80% and switch EQ to Hip-Hop”“Switch audio output to my AirPods Pro”“Turn on shuffle for my Gym playlist”
  • 发现与转换：“Import this Spotify playlist: https://open.spotify.com/playlist/... ”“Generate a universal share link for what's currently playing”“Show me the UK Top 10 Apple Music chart”“Get the lyrics for this song”
  • 分析与 Replay：“Give me my August Replay report”“What is my music listening personality profile?”“Show my listening history for the last 10 songs”
  • DJ 与媒体库工程：“Configure smart DJ crossfades for my 'Party' playlist”“Find and remove duplicate songs in my 'Favorites' playlist”“Export my 'Chill Vibes' playlist to Markdown”

适用场景

  • 希望通过对话式 AI 控制 Mac 上 Apple Music 播放和音量的用户。
  • 需要将 Spotify 歌单迁移到 Apple Music 的用户。
  • 关注收听统计、月度 Replay 报告和收听历史分析的用户。
  • 需要在派对等场景中自动进行 DJ 交叉淡入淡出和歌单去重、排序、导出的用户。

限制

  • 仅支持 macOS，且必须已安装 Apple Music 应用。
  • 需要 uv 包管理器。
  • 首次运行需授予自动化控制 Music.app 的系统权限。
  • Spotify 导入仅支持公开歌单和专辑，且无需登录或令牌。
  • 数据 100% 在本地通过 stdio 运行和保存，不存储或传输凭证、令牌或个人标识。
  • 采用 MIT 许可证。

其他细节（如完整 74 个工具列表、开发与贡献步骤、PRIVACY.md 全文）暂未提供。

同类工具

查看分类