Spotify MCP Server

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

功能

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

可用工具

工具名称	描述
set-spotify-credentials	设置您的Spotify认证凭据
check-credentials-status	检查您的凭据是否有效以及谁已登录
search-tracks	根据名称、艺术家或关键词搜索曲目
get-current-user	获取您的Spotify个人资料信息
create-playlist	在您的账户上创建新的播放列表
add-tracks-to-playlist	向现有播放列表添加曲目
get-recommendations	基于种子曲目获取推荐

安装说明

即插即用 - HTTP Spotify MCP 服务器

1. 访问 Claude AI
2. 点击“添加连接器”
3. 点击“管理连接器”
4. 添加自定义连接器
5. 添加HTTPS服务器链接
6. 发送邮件至hrishi0102business@gmail.com以将您的Spotify ID/邮箱加入白名单
7. 完成。您的Claude现在可以使用Spotify了。您将被提示使用Spotify OAuth登录。

在本地运行Spotify MCP

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
参数：{}

搜索曲目：

搜索Weekend的歌曲

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

创建播放列表：

创建一个新的播放列表，名为"My Pretty pretty girlfriend"

工具：create-playlist
参数：
{
  "name": "My Pretty pretty girlfriend",
  "description": "为我的女朋友。由Claude和Spotify MCP服务器创建"
}

多步骤任务

创建带有歌曲的播放列表：

我想创建一个充满活力的健身播放列表。首先，搜索一些充满活力的歌曲。然后创建一个名为"Workout Mix"的播放列表，并将这些歌曲添加进去。

基于最爱歌曲获取推荐：

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

故障排除

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

注意事项

• 该服务器仅在内存中存储凭据
• 每次开始新的对话时，您都需要设置凭据
• 如果Claude桌面重启，您需要再次设置凭据