Vuples Spotify MCP Server

基本能力

产品定位

Vuples Spotify MCP Server 是一个连接AI助手与Spotify音乐服务的中间件，旨在通过MCP协议为AI助手提供丰富的音乐控制功能。

核心功能

• 通过艺术家、标题或任意查询搜索歌曲
• 在活跃的Spotify设备上直接播放歌曲
• 获取当前播放歌曲的信息
• 查找可用的Spotify播放设备
• 搜索并自动播放最匹配的歌曲
• 列出用户的Spotify播放列表
• 查看播放列表中的歌曲
• 播放播放列表（可选随机播放模式）
• 按名称查找并播放播放列表

适用场景

• AI助手集成音乐播放功能
• 语音控制Spotify播放
• 自动化音乐播放流程
• 开发音乐相关的AI应用

工具列表

• spotify-search: 通过查询搜索歌曲
• spotify-play: 通过ID或URI播放特定歌曲
• spotify-currently-playing: 获取当前播放歌曲的信息
• spotify-devices: 列出可用的Spotify播放设备
• spotify-search-and-play: 搜索歌曲并自动播放最匹配的结果
• spotify-playlists: 获取用户的Spotify播放列表
• spotify-playlist-tracks: 获取特定播放列表中的歌曲
• spotify-play-playlist: 播放特定播放列表（可选随机播放）
• spotify-find-playlist: 按名称查找并播放播放列表

常见问题解答

• "No active device found": 确保Spotify至少在一个设备上打开并播放
• "Missing permissions": 刷新令牌可能缺少必要的权限范围
• "Not premium": 播放控制需要Spotify Premium账户
• "Issues with refresh token": 如果令牌过期，请按照安装部分的步骤生成新的令牌

使用教程

使用依赖

• Node.js (v16+)
• Spotify开发者账户
• Spotify Premium账户（用于播放功能）
• MCP兼容客户端（如Claude Desktop）

安装教程

1. 克隆仓库: bash git clone https://github.com/yourusername/spotify-mcp.git cd spotify-mcp

2. 安装依赖: bash npm install

3. 创建.env文件并添加Spotify API凭证: SPOTIFY_CLIENT_ID=your_client_id SPOTIFY_CLIENT_SECRET=your_client_secret SPOTIFY_REDIRECT_URI=http://localhost:8888 SPOTIFY_REFRESH_TOKEN=your_refresh_token

4. 生成刷新令牌: bash npm run get-token 或 bash node src/simple-auth.js

5. 构建项目: bash npm run build

调试方式

1. 确保Spotify在设备上打开并播放
2. 将服务器添加到Claude Desktop配置中
3. 重启Claude Desktop
4. 检查Spotify工具是否可用

许可证

该项目遵循 MIT 开源许可条款。