Spotify MCP Server (Express.js)

基本能力

产品定位

Spotify MCP Server 是一个连接 AI 助手与 Spotify API 的中间层服务，主要用于音乐内容的搜索、信息获取和用户个性化数据访问。

核心功能

1. 音乐搜索：支持搜索曲目、艺术家或专辑。
2. 信息获取：提供艺术家、曲目和播放列表的详细信息。
3. 用户数据：访问用户的顶级曲目、播放列表和保存的曲目（需要认证）。
4. 认证管理：处理 Spotify OAuth 认证和令牌刷新。

适用场景

1. AI 助手需要为用户提供音乐推荐时。
2. 需要获取特定艺术家或曲目的详细信息时。
3. 用户想要管理自己的 Spotify 播放列表或查看收藏的曲目时。

工具列表

1. /mcp/search：搜索音乐内容。
2. /mcp/artist/{artistId}：获取艺术家信息。
3. /mcp/track/{trackId}：获取曲目信息。
4. /mcp/playlist/{playlistId}：获取播放列表信息。
5. /mcp/me/top-tracks：获取用户的顶级曲目。
6. /mcp/me/playlists：获取用户的播放列表。
7. /mcp/me/tracks：获取用户保存的曲目。
8. /mcp/auth/login：生成 Spotify 登录 URL。
9. /callback：处理 OAuth 回调。
10. /mcp/auth/refresh：刷新访问令牌。

常见问题解答

1. 如何获取 Spotify API 凭证？
2. 需要在 Spotify Developer Dashboard 创建应用并获取 Client ID 和 Client Secret。
3. 如何保护敏感信息？
4. 使用 .env 文件存储凭证，并确保不将其提交到版本控制。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 创建 Spotify 开发者账户并在 Spotify Developer Dashboard 创建新应用。

安装教程

1. 创建 .env 文件并填入以下内容：

SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:3000/callback

1. 安装依赖：

npm install

1. 运行服务器：

npm start

调试方式

1. 确保服务器已启动并监听端口 3000。
2. 使用以下命令测试端点：

curl -X POST http://localhost:3000/mcp/search -H "Content-Type: application/json" -d '{"query":"Bohemian Rhapsody","type":"track"}'

1. 检查返回的 JSON 数据是否符合预期。

许可证

None