← 返回目录

Spotify MCP Server

社区

轻量级的 Spotify MCP 服务器，让 AI 助手控制播放和歌单。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 477 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 16+
凭据: 需要 API Key / 凭据
最近提交: 今天
工具数: 27

38FMRS · D

该服务器提供了丰富的 Spotify 控制功能，但需要用户自担风险进行配置和使用。

最强项 · 安装易用性 12/20 最弱项 · 维护活跃度 2/20

可靠性

6/20

安全与权限

6/20

维护活跃度

2/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: 仅能依据 README 和仓库元数据评审；未提供源码、server manifest、CI 或已提交测试，无法验证 MCP 初始化、tool-list handshake 以及工具声明与实际行为是否一致。README 中的工具参数表看起来连贯，happy path 似乎可行，但错误处理、边界条件和可复现性都没有证据，因此评分保守。
安全与权限 6/20: 没有源码，无法审计凭据存储、网络调用、权限范围或数据边界。README 显示 OAuth client secret 与 access/refresh token 会写入本地的 spotify-config.json，未说明文件权限或最小权限 scope；存在删除/修改类工具，但需要用户显式调用。未发现恶意代码、真实密钥或强制破坏性默认值，不触发红线，但关键安全细节缺失，只能给低分。
维护活跃度 2/20: 元数据显示仓库未被 archived，但有 19 个 open issues；License 为 unknown，且没有提交记录、发布版本、依赖更新或安全响应渠道的证据。许可证缺失和治理信息不透明是明显扣分项，因此维护分很低。
文档质量 12/20: README 覆盖了工具说明、参数、示例、安装步骤、Spotify OAuth 配置以及 Claude/Cursor/Cline 的接入方式，文档结构较完整。但缺少故障排查、已知限制、成本/权限边界和许可证信息，且没有源码可以核对文档与实现是否一致，因此不能给满分。
安装易用性 12/20: 安装步骤清晰，包括 Node 版本、clone、build、创建 Spotify 开发者应用、认证流程和主流客户端配置示例，按文档操作路径完整。但没有 CI 或已提交测试作为可执行证据，平台兼容性和手动 OAuth 的易碎点也未说明；按照静态校准要求，setup 最高不超过 15，故给 12。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

开发者希望将 Spotify 控制集成到 AI 助手或自定义应用中。
需要快速实现播放、歌单管理、音量调节等功能的场景。
已经拥有 Spotify Premium 账号和开发者应用的用户。

不适合谁

没有 Spotify Premium 账号的用户，因为部分功能（如播放控制、音量调节）需要 Premium。
希望使用官方支持或生产级解决方案的用户，因为此服务器是第三方维护且未官方认证。
需要 HTTPS 传输或远程访问的场景，因为此服务器仅支持 stdio。

所需权限

访问用户的 Spotify 数据，包括播放列表、已点赞歌曲、最近播放记录。
控制播放，包括播放、暂停、跳转、音量调节等。
修改用户的播放列表（如创建、删除、添加、移除曲目）。
访问设备信息（如可用设备、当前设备等）。

风险与副作用

安全风险：OAuth 令牌存储在本地 spotify-config.json 文件中，如果泄露可能导致账号被滥用。
隐私风险：AI 助手可能访问用户的播放历史、歌单等个人数据。
误操作风险：AI 可能执行意外的播放操作或修改歌单，导致播放中断或歌单错乱。
非官方：服务器非 Spotify 官方维护，可能存在缺陷或安全漏洞。

安装接入

准备工作

运行环境：Node.js 16+

确保 Node.js v16+ 和 Spotify Premium 账号。
克隆仓库：git clone https://github.com/marcelmarais/spotify-mcp-server.git
进入目录并安装依赖：cd spotify-mcp-server && npm install && npm run build
在 Spotify Developer Dashboard 创建应用，获取 Client ID 和 Client Secret，并设置重定向 URI（如 http://127.0.0.1:8888/callback）。
创建 spotify-config.json 文件，填入 clientId、clientSecret、redirectUri。
运行 npm run auth 进行 OAuth 认证，授权后令牌自动保存到配置文件中。
将服务器添加到您的 MCP 客户端配置中，例如 Claude Desktop：

{
"mcpServers": {
"spotify": {
"command": "node",
"args": ["spotify-mcp-server/build/index.js"]
}
}
}

claude_desktop_config.json

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": [
        "spotify-mcp-server/build/index.js"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "spotify": {
      "command": "node",
      "args": [
        "spotify-mcp-server/build/index.js"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add spotify -- node spotify-mcp-server/build/index.js

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应看到 searchSpotify、getNowPlaying 等工具；可让 AI 调用 getNowPlaying，若能返回当前播放曲目及设备信息，说明连接成功。

常见排障

认证失败：检查 spotify-config.json 中的 clientId、clientSecret 和 redirectUri 是否正确，并确保重定向 URI 与 Developer Dashboard 中设置的一致。
令牌过期：运行 npm run auth 重新认证，服务器应自动刷新，但若失败需手动重新认证。
无法播放：确保有活动的 Spotify 设备，且用户有 Premium 账号。
命令未找到：确保已安装依赖并运行 npm run build 生成构建文件。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

播放 Elvis 的第一首歌
创建一个 Taylor Swift 和 Slipknot 风格融合的歌单
把我锻炼歌单里所有 techno 曲目复制到工作歌单
把音量调低一点

工具能力 27

searchSpotify 只读

在 Spotify 上搜索曲目、专辑、艺术家或播放列表。

getNowPlaying 只读

获取当前播放曲目信息，包括设备、音量、进度等。

getMyPlaylists 只读

获取当前用户的播放列表。

getPlaylistTracks 只读

获取指定播放列表中的曲目列表。

getRecentlyPlayed 只读

获取最近播放的曲目列表。

getUsersSavedTracks 只读

获取用户‘已点赞歌曲’库中的曲目列表。

getQueue 只读

获取当前播放队列中的曲目和即将播放的曲目。

getAvailableDevices 只读

获取可用的 Spotify Connect 设备信息。

展开其余 19 个工具

removeUsersSavedTracks 破坏性

从‘已点赞歌曲’库中移除一个或多个曲目。

playMusic 写入

开始播放曲目、专辑、艺术家或播放列表。

pausePlayback 写入

暂停当前播放的曲目。

resumePlayback 写入

恢复播放。

skipToNext 写入

跳转到下一首曲目。

skipToPrevious 写入

跳转到上一首曲目。

createPlaylist 写入

创建新的 Spotify 播放列表。

addTracksToPlaylist 写入

向现有播放列表添加曲目。

addToQueue 写入

将曲目、专辑、艺术家或播放列表添加到当前播放队列。

setVolume 写入

设置播放音量为指定百分比（需要 Premium）。

adjustVolume 写入

相对调节音量大小（需要 Premium）。

getAlbums 只读

获取一个或多个专辑的详细信息。

getAlbumTracks 只读

获取指定专辑的曲目列表，支持分页。

saveOrRemoveAlbumForUser 写入

保存或移除用户‘你的音乐’库中的专辑。

checkUsersSavedAlbums 只读

检查专辑是否已保存在用户的‘你的音乐’库中。

getPlaylist 只读

获取指定播放列表的详细信息。

updatePlaylist 写入

更新播放列表的名称、描述、公开/私有、协作等。

removeTracksFromPlaylist 破坏性

从播放列表中移除一个或多个曲目。

reorderPlaylistItems 写入

重新排序播放列表中的曲目。

使用场景

播放特定歌曲或专辑：如‘播放猫王的第一首歌’。

创建融合歌单：如‘创建一个 Taylor Swift / Slipknot 的融合播放列表’。

复制歌单：如‘将我的健身歌单中的所有 techno 曲目复制到工作歌单中’。

调节音量：如‘把音量调低一点’。

获取当前播放信息：查询正在播放的歌曲、设备、音量等。

支持客户端

Claude Desktop

Cursor

Cline

依据项目文档列出，未经本站实测。

详细介绍

这是一个轻量级的 MCP 服务器，使 AI 助手（如 Cursor 和 Claude）能够控制 Spotify 播放和管理播放列表。它提供搜索、播放控制、歌单管理、音量调节等功能。需要 Spotify Premium 账号和开发者应用。