spotify-mcp-server 是一个轻量级的 Model Context Protocol（MCP）服务器，目标是让 Cursor、Claude 等 AI 助手能够控制 Spotify 播放并管理播放列表。
用途 该项目把 Spotify 的播放控制与播放列表管理能力封装为 MCP 工具，使 AI 助手可以通过自然语言指令完成搜索、播放、切歌、查看队列、创建播放列表等操作。资料中给出的示例交互包括："Play Elvis's first song"、"Create a Taylor Swift / Slipknot fusion playlist"、"Copy all the techno tracks from my workout playlist to my work playlist"、"Turn the volume down a bit"。
主要能力 项目按工具类别组织，包括 Read Operations、Album Operations、Play / Create Operations、Playlist Operations。资料中明确列出的工具如下：
读取类：
- searchSpotify：搜索 Spotify 上的曲目、专辑、艺人或播放列表。参数包括 query（搜索词）、type（track、album、artist、playlist）、limit（1-10，默认 10）、offset（默认 0）。返回匹配项的 ID、名称及附加信息。
- getNowPlaying：获取当前播放曲目信息，包括设备与音量信息。无参数。返回曲目名、艺人、专辑、播放进度、时长、播放状态、设备信息、音量以及随机/循环状态。
- getMyPlaylists：获取当前用户的播放列表。参数 limit（默认 20）、offset（默认 0）。返回播放列表的 ID、名称、曲目数与公开状态。
- getPlaylistTracks：获取指定播放列表中的曲目。参数 playlistId、limit（默认 100）、offset（默认 0）。返回曲目的 ID、名称、艺人、专辑、时长与添加日期。
- getRecentlyPlayed：获取最近播放的曲目。参数 limit（可选）。若找到曲目则返回格式化列表，否则返回提示信息。
- getUsersSavedTracks：获取用户"Liked Songs"中保存的曲目。参数 limit（1-50，默认 50）、offset（默认 0）。返回曲目名、艺人、时长、曲目 ID 及加入时间，并显示分页信息。
- getQueue：获取当前播放曲目与队列中即将播放的项目。参数 limit（1-50，默认 10）。
- getAvailableDevices：获取用户可用的 Spotify Connect 设备。无参数。返回设备名称、类型、活动状态、音量与设备 ID。
- getFollowedArtists：获取当前用户关注的艺人。参数 limit（1-50，默认 20）、after（上一页最后一位艺人 ID 作为游标）。返回艺人名称与 ID，Spotify 提供时还包括热度与流派，并在还有更多结果时返回下一页游标。
播放与创建类：
- playMusic：开始播放曲目、专辑、艺人或播放列表。参数 uri（覆盖 type 与 id）、type、id、deviceId。
- pausePlayback：暂停当前播放。参数 deviceId（可选）。
- resumePlayback：在活动设备上恢复播放。参数 deviceId（可选）。
- skipToNext：跳到队列中的下一首。参数 deviceId（可选）。
- skipToPrevious：跳到队列中的上一首。参数 deviceId（可选）。
- createPlaylist：创建新播放列表。参数 name、description（可选）、public（可选，默认 false）。返回新播放列表的 ID 与 URL。
- addTracksToPlaylist：向已有 Spotify 播放列表添加曲目（资料在此处截断，未提供完整参数说明）。
- removeUsersSavedTracks：从用户"Liked Songs"中移除一首或多首曲目（每次最多 40 首）。参数 trackIds（数组，最多 40 个）。
使用方式 资料给出的设置流程包括：Prerequisites（前置条件）、Installation（安装）、Creating a Spotify Developer Application（创建 Spotify 开发者应用）、Spotify API Configuration（Spotify API 配置）、Authentication Process（认证流程）。集成方式包括：与 Claude Desktop、Cursor 和 VsCode（Cline）集成；Streamable HTTP；OAuth（MCPHub 及其他支持 OAuth 的客户端）；Docker（推荐用于 MCPHub）。资料未提供具体的安装命令、配置代码或认证步骤细节。
适用场景 适合希望通过 AI 助手以自然语言控制 Spotify 播放、查询播放状态、管理播放列表与"Liked Songs"的用户，也适合需要将 Spotify 能力接入支持 MCP 的客户端（如 Claude Desktop、Cursor、VS Code/Cline、MCPHub）的场景。
限制 资料未说明收费、价格、平台支持范围、性能或效果等信息。部分工具（如 addTracksToPlaylist）的参数说明在资料中不完整。使用前需要创建 Spotify 开发者应用并完成 API 配置与认证。
