Spotify MCP服务器

本项目 'spotify-mcp' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 提供与 Spotify 音乐平台交互的能力。通过此 MCP 服务器，LLM 客户端可以调用预定义工具，实现对 Spotify 的控制和数据访问。

主要功能点:

音乐播放控制: 支持开始、暂停、跳过 Spotify 音乐播放，以及获取当前播放的歌曲信息。
音乐搜索: 允许用户通过关键词搜索 Spotify 上的歌曲、专辑、艺术家和播放列表。
播放队列管理: 可以查看当前播放队列，并将歌曲添加到播放队列中。
音乐信息查询: 能够获取歌曲、专辑、艺术家和播放列表的详细信息。

安装步骤:

克隆仓库: 首先，将 GitHub 仓库克隆到本地：

git clone https://github.com/MCP-Mirror/varunneal_spotify-mcp.git
cd spotify-mcp

安装依赖: 建议使用 'uv' 包管理器同步依赖 (如果未安装，请先安装 uv: https://astral.sh/uv)，或者使用 'pip' 安装 'requirements.txt' 中的依赖。
```
uv sync
```
或者
```
pip install -r requirements.txt
```
配置 Spotify API 密钥:
- 访问 Spotify Developer Dashboard 并创建一个应用。
- 设置 'redirect_uri' 为 'http://localhost:8888' (端口可以自定义，但必须使用 'http' 和 'localhost')。
- 在应用设置中获取 'Client ID' 和 'Client Secret'。
- 复制 '.env.example' 文件并重命名为 '.env'，然后将您的 'Client ID'、'Client Secret' 和 'Redirect URI' 填入 '.env' 文件中。

服务器配置 (MCP 客户端配置):

要将 'spotify-mcp' 服务器添加到 MCP 客户端 (例如 Claude)，您需要在客户端的配置文件中添加服务器信息。以下是配置示例，以 JSON 格式提供：

{
  "spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify_mcp",  //  **请替换为 spotify-mcp 仓库在您本地的实际路径**
      "run",
      "spotify-mcp"
    ],
    "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"': 服务器名称，在 MCP 客户端中用于标识和调用此服务器。可以自定义。
'"command"': 启动服务器的命令。这里使用 'uv' 命令，如果您使用 'pip' 安装，并且直接使用 'python' 运行，则可以修改为 '"command": "python"'。
'"args"': 传递给启动命令的参数列表。
- '"--directory"': 指定服务器代码所在的目录，请务必将其替换为 'spotify-mcp' 仓库在您本地的实际路径。
- '"run"': 'uv run' 的子命令，用于运行 Python 包。如果使用 'python' 命令，则 'args' 需要修改为服务器主程序 'server.py' 的路径。
- '"spotify-mcp"': 指定要运行的 Python 包名称。如果使用 'python' 命令，则需要替换为 'src/spotify_mcp/server.py' (相对于仓库根目录的路径)。
'"env"': 设置服务器运行所需的环境变量。
- '"SPOTIFY_CLIENT_ID"', '"SPOTIFY_CLIENT_SECRET"', '"SPOTIFY_REDIRECT_URI"': Spotify API 密钥和 Redirect URI，需要替换为您在 Spotify 开发者平台获取到的值。

基本使用方法:

确保 MCP 客户端已正确配置 'spotify-mcp' 服务器。
启动 MCP 客户端。客户端会自动连接并注册 'spotify-mcp' 服务器提供的工具。
在 MCP 客户端中，您可以使用自然语言指令调用 Spotify 工具。例如，您可以向 Claude (或其他 MCP 客户端) 提出类似以下的问题或指令：
- "播放 Drake 的歌曲"
- "搜索周杰伦的专辑"
- "暂停音乐播放"
- "我的播放队列里有什么？"
- "添加这首歌到播放队列"
- "获取 Taylor Swift 最新专辑的信息"

MCP 客户端会将这些指令转换为对 'spotify-mcp' 服务器的工具调用，从而实现与 Spotify 的交互。

注意:

首次运行时，可能需要进行 Spotify 账户授权。请按照提示在浏览器中完成授权流程。
确保您的 Spotify 账户已登录，并且设备已连接到互联网。

关键词

Spotify MCP服务器

信息