🚀 Spotify MCP 服务器

这是一个简单的模型上下文协议（MCP）服务器，允许你通过 Claude 与 Spotify 进行交互。该服务器使 Claude 能够使用你的 Spotify 账户搜索歌曲、创建播放列表、获取推荐等。

✨ 主要特性

• 在 Spotify 上搜索曲目
• 查看你的 Spotify 个人资料
• 创建播放列表
• 向播放列表添加曲目
• 获取个性化音乐推荐

📦 安装指南

1. 前提条件

• Node.js v16 或更高版本
• npm
• 一个 Spotify 账户
• 一个已注册的 Spotify 开发者应用程序

2. 创建 Spotify 开发者应用

1. 访问 Spotify 开发者控制台
2. 使用你的 Spotify 账户登录
3. 点击“创建应用”
4. 填写应用名称和描述
5. 添加 http://localhost:8888/callback 作为重定向 URI
6. 记录你的客户端 ID 和客户端密钥

3. 安装项目

# 先克隆或下载项目
cd spotify-mcp-server

# 安装依赖项
npm install

4. 获取你的 Spotify 令牌

编辑 spotify-auth.js 文件，包含你的客户端 ID 和客户端密钥：

// 用你的 Spotify 应用凭证替换这些内容
const CLIENT_ID = "your_client_id_here";
const CLIENT_SECRET = "your_client_secret_here";

然后运行身份验证脚本：

node spotify-auth.js

这将：

1. 在你的浏览器中打开一个 URL
2. 提示你登录 Spotify
3. 请求你允许访问你的账户
4. 将令牌保存到 secrets.json

5. 构建 MCP 服务器

npm run build

6. 配置 Claude 桌面应用

编辑你的 Claude 桌面应用配置文件：

• 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json 添加以下配置：

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

将 /full/path/to/spotify-mcp-server 替换为你的项目目录的实际路径。

7. 重启 Claude 桌面应用

关闭并重新打开 Claude 桌面应用以加载新配置。

💻 使用示例

基础用法

当你开始与 Claude 对话时，你首先需要设置你的 Spotify 凭证：

1. 查看你的 secrets.json 文件以获取凭证
2. 使用 set-spotify-credentials 工具进行身份验证
3. 然后使用任何其他 Spotify 工具

示例提示

设置凭证

我想连接到我的 Spotify 账户。以下是我从 secrets.json 中获取的凭证：

工具：set-spotify-credentials
参数：
{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "accessToken": "your_access_token",
  "refreshToken": "your_refresh_token"
}

基本命令

检查你的账户：

你能检查我在 Spotify 上以谁的身份登录吗？

工具：get-current-user
参数：{}

搜索曲目：

搜索 The Weeknd 的歌曲

工具：search-tracks
参数：
{
  "query": "The Weeknd",
  "limit": 5
}

创建播放列表：

创建一个名为“我的漂亮女友”的新播放列表

工具：create-playlist
参数：
{
  "name": "My Pretty pretty girlfriend",
  "description": "For my girlfriend. Created with Claude and the Spotify MCP server"
}

多步骤任务

创建包含歌曲的播放列表：

我想创建一个包含活力歌曲的健身播放列表。首先，搜索一些高能量的歌曲。然后创建一个名为“健身混音”的播放列表，并将这些歌曲添加到其中。

根据喜爱的歌曲获取推荐：

我喜欢 The Weeknd 的歌曲“Blinding Lights”。你能搜索这首歌，然后找到类似的歌曲，并创建一个包含这些推荐歌曲的播放列表吗？

📚 详细文档

可用工具

🔧 故障排除

• 错误：没有可用的访问令牌：你需要首先使用 set-spotify-credentials 工具设置你的凭证
• 身份验证失败：你的令牌可能已过期。再次运行身份验证脚本以获取新的令牌
• 无效的凭证：仔细检查你是否使用了正确的客户端 ID 和客户端密钥

📄 注意事项

⚠️ 重要提示

• 服务器仅将凭证存储在内存中
• 每次开始新对话时，你都需要设置凭证
• 如果 Claude 桌面应用重启，你需要再次设置凭证