MCP 服务器

Vulpes Spotify MCP Server

一个模型上下文协议服务器，使像 Claude 这样的人工智能助手能够与 Spotify 互动，从而允许它们搜索曲目、控制播放和管理播放列表。

README

Vuples Spotify MCP 服务器

一个模型上下文协议 (MCP) 服务器，使像 Claude 这样的人工智能助手能够与 Spotify 交互，允许它们搜索和播放曲目。

功能

按艺术家、标题或任何查询搜索曲目
直接在您活跃的 Spotify 设备上播放曲目
获取有关您当前播放曲目的信息
查找可用的 Spotify 播放设备
组合搜索和播放功能
列出用户的 Spotify 播放列表
查看播放列表中的曲目
播放播放列表（带有可选的随机播放模式）
按名称查找和播放播放列表

要求

Node.js (v16+)
Spotify 开发者帐户
Spotify Premium 帐户（用于播放功能）
兼容 MCP 的客户端（例如，Claude Desktop）

安装

克隆此存储库：

git clone https://github.com/yourusername/spotify-mcp.git
cd spotify-mcp

安装依赖项：
```
npm install
```

创建一个包含您的 Spotify API 凭据的 .env 文件：

SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:8888

# 可选：用于播放控制
SPOTIFY_REFRESH_TOKEN=your_refresh_token

您可以从 Spotify 开发者仪表板获取您的 Client ID 和 Secret。

生成一个刷新令牌（播放控制需要）：

有两种方法可以获取刷新令牌：

选项 1：使用内置脚本
```
npm run get-token
```
这将启动一个本地服务器并在终端中提供说明。

选项 2：使用简单脚本（如果选项 1 不起作用）
```
node src/simple-auth.js
```
这将为您提供一个 URL，您可以在浏览器中打开它。授权后，您将被重定向到一个 URL。将该 URL 复制回终端，它将显示一个 curl 命令来获取刷新令牌。

所需的 scopes（已包含在脚本中）：
- user-read-playback-state
- user-modify-playback-state
- user-read-currently-playing
- playlist-read-private
- playlist-read-collaborative
将刷新令牌添加到您的 .env 文件：
```
SPOTIFY_REFRESH_TOKEN=your_refresh_token
```
构建项目：
```
npm run build
```

与 Claude Desktop 一起使用

首先，确保 Spotify 已打开并在您的设备上播放

将此服务器添加到您的 Claude Desktop 配置：

编辑您的 claude_desktop_config.json 文件（通常在 macOS 上的 ~/Library/Application Support/Claude/ 或 Windows 上的 %APPDATA%\\Claude\\ 中）：

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/absolute/path/to/vulpes-spotify-mcp/dist/index.js"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret",
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
        "SPOTIFY_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}