Spotify MCP Server

Spotify MCP 服务

Spotify MCP 服务 是一个 Model Context Protocol（MCP）服务，旨在与 Spotify API 交互。它提供了控制 Spotify 播放的工具，例如播放、暂停、跳过曲目、随机播放播放列表等。此服务使用 mcp 框架和 spotipy 库构建。

功能

• 播放、暂停和跳过曲目。
• 随机播放和循环播放播放列表。
• 按名称播放指定专辑或曲目。
• 内置工具，可无缝控制 Spotify 播放。

前置条件

设置服务之前，请确保具备以下条件：

1. Python 3.12 或更高版本。
2. 拥有已注册应用的 Spotify 开发者账户。你需要：
   • SPOTIFY_CLIENT_ID
   • SPOTIFY_CLIENT_SECRET
3. 包含 Spotify 凭据的 .env 文件。
4. 一个 Spotify Premium 账户

安装

1. 克隆仓库：

   git clone <repository-url>
   cd spotify-mcp-server
   

2. 创建并激活虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 安装用于依赖项管理的 uv：

   pip install uv
   

   Windows

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

4. 使用 uv 根据 pyproject.toml 文件安装依赖项：

   uv sync
   

5. 在项目根目录创建 .env 文件，并添加 Spotify 凭据：

   SPOTIFY_CLIENT_ID=your_client_id
   SPOTIFY_CLIENT_SECRET=your_client_secret
   

使用方法

1. 启动 MCP 服务：

   python server.py
   

2. 使用提供的工具控制 Spotify 播放。例如：

   • play()：开始播放当前曲目。
   • pause()：暂停当前曲目。
   • next_track()：跳到下一首曲目。
   • play_album("album_name")：按名称播放指定专辑。
   • play_track("track_name")：按名称播放指定曲目。

3. 将 MCP 工具添加到 MCP 客户端。例如，如果你使用 Claude： 在项目根目录添加以下内容

   uv mcp install server.py
   

Example Using Calude Desktop

Here is the JSON file

{
"mcpServers": {
  "spotify-mcp-server": {
    "command": "~path-to-project\\spotify-mcp-server\\.venv\\Scripts\\python.exe",
    "args": [
      "~path-to-project\\spotify-mcp-server\\server.py"
    ],
    "transport": "stdio",
    "env":{
      "SPOTIFY_CLIENT_ID": "############",
      "SPOTIFY_CLIENT_SECRET": "############",
      "TRANSPORT": "stdio"
    }
  }
}
}

Troubleshooting

• Spotify Authentication Failed: Ensure your SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET are correctly set in the .env file.

• Server Not Starting: Verify that the __name__ check in server.py is correctly set to __server__:

   if __name__ == "__server__":
    mcp.run()
  

贡献

欢迎贡献！你可以提交问题或拉取请求。