SuperAPI AI 工具集

controlling-spotify

智能体与模型

查看项目

更新于 10-16 02:35

技能介绍

用途:让 AI 助手通过 Spotify MCP Server 操作用户的 Spotify 账户,包括播放控制、音乐搜索和播放列表管理。

主要能力:读取类操作有 searchSpotify(搜索曲目/专辑/艺人/播放列表)、getNowPlaying(当前播放)、getMyPlaylists、getPlaylistTracks、getRecentlyPlayed、getUsersSavedTracks;播放控制有 playMusic、pausePlayback、skipToNext、skipToPrevious、addToQueue;播放列表管理有 createPlaylist、addTracksToPlaylist;专辑操作有 getAlbums、getAlbumTracks、saveOrRemoveAlbumForUser。

使用方式:需先完成一次性设置——在 https://developer.spotify.com/dashboard/ 创建应用,记录 Client ID 与 Client Secret,添加回调地址 http://127.0.0.1:8888/callback;本地运行辅助脚本获取长期 refresh token;在技能配置中填入 SPOTIFY_CLIENT_ID、SPOTIFY_CLIENT_SECRET、SPOTIFY_REFRESH_TOKEN 三项凭据(也可通过 Project Knowledge 的 .env 风格文件提供)。随后安装 MCP Server:bash scripts/install-mcp-server.sh,并配置 MCP 客户端以 node 启动构建产物。

适用场景:播放/暂停/切歌、搜索歌曲、查看正在播放、创建或修改播放列表、管理收藏与队列等。

限制:播放控制类操作需要 Spotify Premium,免费账户仅支持搜索与读取;播放命令需要存在活跃的 Spotify 设备会话;Spotify API 有速率限制(通常每分钟 180 次请求);refresh token 拥有账户完整访问权限,须妥善保管,用户可在 https://www.spotify.com/account/apps/ 撤销。URI 格式为 spotify:track:ID 等。缺少凭据时技能无法运行。