MCP 服务器

Spotify MCP Server

一个模型上下文协议（Model Context Protocol，MCP）服务器，它允许通过 MCP 客户端（如 Cursor 或 Claude for Desktop）中的自然语言命令来控制 Spotify 的播放。

README

Spotify MCP 服务器

本项目实现了一个模型上下文协议 (MCP) 服务器，允许你通过 MCP 客户端（例如 Cursor 或 Claude for Desktop (仅限 macOS 和 Windows)）使用自然语言控制 Spotify 播放。

功能

此服务器公开以下工具：

play: 播放曲目、专辑或播放列表，或恢复播放。
pause: 暂停播放。
next: 跳到下一曲。
previous: 跳到上一曲。
get_current_track: 获取当前播放曲目的信息。
search: 搜索曲目、专辑、艺术家或播放列表。

前提条件

Bun (1.0.0 或更高版本)
一个 Spotify Premium 帐户。
一个 Spotify 开发者应用程序：
- 在 Spotify 开发者仪表板创建一个。
- 获取你的 Client ID 和 Client Secret。
- 将 http://localhost:8888/callback 添加到你的应用程序设置中的 Redirect URIs。
一个 MCP 客户端（例如 Cursor 或 Claude for Desktop）。

安装和设置

克隆存储库：

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

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

创建 .env 文件：

在项目根目录中创建一个名为 .env 的文件。添加以下内容，并将占位符替换为你的实际 Spotify 凭据：

SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:8888/callback
# 这些将在运行授权脚本后填充：
SPOTIFY_ACCESS_TOKEN=
SPOTIFY_REFRESH_TOKEN=

运行授权脚本：

此脚本将打开你的浏览器，提示你登录 Spotify 并授予权限，然后检索你的初始访问令牌和刷新令牌。
```
bun run auth
```
该脚本会将 SPOTIFY_ACCESS_TOKEN 和 SPOTIFY_REFRESH_TOKEN 打印到控制台。将这些值复制到你的 .env 文件中。

配置你的 MCP 客户端：

Cursor:

打开 Cursor 的设置 (Cmd+, 或 Ctrl+,)。
搜索 "Model Context Protocol"。
单击 "Edit in settings.json"。

将以下内容添加到 mcp.servers 数组（将 /absolute/path/to/your/spotify-mcp 替换为你的 spotify-mcp 目录的绝对路径）：

{
    "mcp.servers": [
        {
            "spotify": {
                "command": "bun",
                "args": ["/absolute/path/to/your/spotify-mcp/src/index.ts"],
                "env": {
                    "SPOTIFY_CLIENT_ID": "your_spotify_client_id",
                    "SPOTIFY_CLIENT_SECRET": "your_spotify_client_secret",
                    "SPOTIFY_REDIRECT_URI": "http://localhost:8888/callback",
                    "SPOTIFY_ACCESS_TOKEN": "your_spotify_access_token",
                    "SPOTIFY_REFRESH_TOKEN": "your_spotify_refresh_token"
                }
            }
        }
    ]
}

建议使用 .env 文件，并且只将与 Spotify 相关的环境变量放在那里，而不是将值添加到 settings.json 文件中。

Claude for Desktop (macOS/Windows):

打开 Claude for Desktop 配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
将以下内容添加到 mcpServers 对象（将 /absolute/path/to/your/spotify-mcp 替换为你的 spotify-mcp 目录的绝对路径）：

 {
   "mcpServers": {
     "spotify": {
       "command": "bun",
       "args": ["/absolute/path/to/your/spotify-mcp/src/index.ts"]
     }
   }
 }
 ```
 建议使用 `.env` 文件，并且只将与 Spotify 相关的环境变量放在那里，而不是将值添加到 `claude_desktop_config.json` 文件中。