Spotify Connector MCP Server 使用说明

项目简介

Spotify Connector MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它作为一个桥梁，连接大型语言模型 (LLM) 客户端和 Spotify 音乐服务。通过这个 MCP 服务器，LLM 可以调用预设的工具来控制 Spotify，实现音乐播放、搜索、队列管理等功能，为用户提供更加智能化的音乐互动体验。

主要功能点

播放控制: 支持开始、暂停、跳过 Spotify 音乐播放，以及获取当前播放曲目的信息。
音乐搜索: 允许通过关键词搜索 Spotify 上的歌曲、专辑、艺术家和歌单。
队列管理: 可以查看当前播放队列，并向队列中添加歌曲。
信息查询: 获取 Spotify 音乐条目的详细信息，例如歌曲、专辑、艺术家和歌单的详细数据。

安装步骤

克隆仓库 打开终端，执行以下命令克隆 GitHub 仓库到本地：

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

安装依赖 确保您已安装 uv。然后使用 'uv' 安装项目依赖：
```
uv sync
```
配置 Spotify API 密钥
- 访问 Spotify Developer Dashboard 并创建一个应用。
- 设置 Redirect URI 为 'http://localhost:8888' (或者您选择的其他端口，但必须使用 'http' 和 'localhost')。
- 记下您的 Client ID 和 Client Secret。
- 在项目根目录下，复制 '.env.example' 文件并重命名为 '.env'，然后将您的 Spotify API 密钥填入 '.env' 文件中：
```
SPOTIFY_CLIENT_ID=YOUR_CLIENT_ID
SPOTIFY_CLIENT_SECRET=YOUR_CLIENT_SECRET
SPOTIFY_REDIRECT_URI=http://localhost:8888
```

服务器配置

要将此 MCP 服务器添加到 Claude 等 MCP 客户端，您需要编辑客户端的配置文件。以 Claude Desktop 应用为例，配置文件路径如下：

MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在配置文件中，添加一个新的服务器配置项，例如命名为 "spotify"：

"spotify": {
  "command": "uv",  // 启动服务器的命令，这里假设使用 uv 运行
  "args": [
    "--directory",  // 指定工作目录
    "/path/to/spotify_mcp",  // 替换为您的 spotify-mcp 项目的本地路径
    "run",         // uv 的 run 命令
    "spotify-mcp"   // 运行 spotify-mcp 包，对应 src/spotify_mcp/__init__.py 中的 main 函数
  ],
  "env": {
    "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",      // 您的 Spotify Client ID，请替换为实际值
    "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET", // 您的 Spotify Client Secret，请替换为实际值
    "SPOTIFY_REDIRECT_URI": "http://localhost:8888" // Spotify Redirect URI，与您在 Spotify Developer Dashboard 中设置的保持一致
  }
}

请注意:

将 '/path/to/spotify_mcp' 替换为您实际的 'spotify-mcp' 项目的本地路径。
将 'YOUR_CLIENT_ID' 和 'YOUR_CLIENT_SECRET' 替换为您在 Spotify Developer Dashboard 中获得的 Client ID 和 Client Secret。

基本使用方法

确保 Spotify Connector MCP Server 已正确配置并启动。
打开您的 MCP 客户端（例如 Claude）。
在客户端中，您应该能够看到名为 "SpotifyPlayback"、"SpotifySearch"、"SpotifyQueue" 和 "SpotifyGetInfo" 的工具。
通过自然语言指示客户端使用这些工具来控制 Spotify。例如，您可以对 Claude 说：
- "暂停 Spotify 播放"
- "搜索周杰伦的歌"
- "播放我喜欢的歌单"
- "把这首歌加入播放队列"
- "现在放的是什么歌"

客户端会将您的自然语言指令转换为对 MCP 服务器的工具调用，从而实现对 Spotify 的控制。

关键词