Spotify MCP 服务器（Express.js）

这是一个实现模型上下文协议（MCP）的 Spotify 服务器，允许 AI 助手与 Spotify 的 API 进行交互。该服务器提供了搜索曲目、获取艺术家信息以及管理播放列表等功能。

设置步骤

1. 在 Spotify 开发者控制台创建一个开发者账户，并在 Spotify 开发者仪表盘 创建一个新的应用。
2. 从你的 Spotify 应用中获取 客户端 ID 和 客户端密钥。
3. 在项目根目录下创建一个 .env 文件，内容如下：

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

4. 安装依赖项：

npm install

5. 启动服务器：

npm start

可用端点

该服务器实现了以下 MCP 端点：

• POST /mcp/search - 搜索曲目、艺术家或专辑。
• GET /mcp/artist/{artistId} - 获取艺术家的详细信息。
• GET /mcp/track/{trackId} - 获取曲目的详细信息。
• GET /mcp/playlist/{playlistId} - 获取播放列表的信息。
• GET /mcp/me/top-tracks - 获取用户的最常听歌曲（需要身份验证）。
• GET /mcp/me/playlists - 获取用户的所有播放列表（需要身份验证）。
• GET /mcp/me/tracks - 获取用户的收藏曲目（需要身份验证）。
• GET /mcp/auth/login - 生成 Spotify 登录 URL 进行用户身份验证。
• GET /callback - 处理 Spotify OAuth 回调并交换授权码为访问令牌。
• POST /mcp/auth/refresh - 刷新用户的访问令牌。

示例用法

以下是 AI 助手如何与服务器交互的示例：

// 搜索曲目
const searchResponse = await fetch('http://localhost:3000/mcp/search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'Bohemian Rhapsody',
    type: 'track'
  })
});
const searchData = await searchResponse.json();

// 获取艺术家信息
const artistResponse = await fetch('http://localhost:3000/mcp/artist/1dfeR4HaWDbWqJHLk5g1d1');
const artistData = await artistResponse.json();

MCP 协议实现

该服务器实现了模型上下文协议，允许 AI 助手：

1. 使用 Spotify 进行身份验证。
2. 搜索音乐内容。
3. 获取艺术家、曲目和播放列表的详细信息。
4. 访问用户个性化数据（需进行适当的身份验证）。

安全注意事项

确保 .env 文件的安全性，切勿将其提交到版本控制。服务器通过环境变量管理敏感凭证，以确保安全。