spotify-mcp：让Claude成为你的音乐控制中枢

spotify-mcp 是一款开源音乐工具，通过 Claude 协议与 Spotify 无缝衔接，实现跨平台控制音乐播放、管理播放列表等功能。该项目基于 Spotify Web API 开发，支持 macOS 和 Windows 系统，为用户提供便捷的音乐控制体验。

价值定位：重新定义音乐交互方式

spotify-mcp 作为连接 Claude 与 Spotify 的桥梁，核心价值在于打破传统音乐控制边界，让用户通过自然语言交互实现对音乐播放的精准控制。其模块化设计确保功能扩展灵活，JSON 配置简化集成流程，为开发者和普通用户提供双重便利。

核心优势

• 协议级整合：深度融合 Claude 协议与 Spotify Web API，实现指令无缝传递
• 跨平台适配：原生支持 macOS/Windows 系统，兼容主流桌面环境
• 轻量化架构：核心代码精简，资源占用低，运行稳定

技术解析：协议交互与系统架构

OAuth 2.0 认证流程

项目采用 OAuth 2.0 认证机制，通过以下流程建立安全连接：

1. 客户端请求 Spotify 授权
2. 用户确认授权后获取访问令牌
3. 通过令牌调用 Spotify Web API 实现功能控制

# 核心认证逻辑示例（spotify_api.py）
def get_spotify_client():
    token = util.prompt_for_user_token(
        scope="user-read-playback-state user-modify-playback-state",
        client_id=CLIENT_ID,
        client_secret=CLIENT_SECRET,
        redirect_uri=REDIRECT_URI
    )
    return spotipy.Spotify(auth=token)

模块交互设计

系统核心模块通过松耦合方式协同工作：

• server.py：处理 Claude 协议请求
• spotify_api.py：封装 Spotify API 调用
• utils.py：提供配置解析、日志处理等辅助功能

场景落地：分角色应用指南

开发者场景

1. 二次开发：基于开放 API 扩展自定义指令
2. 智能设备集成：对接智能家居系统实现语音控制
3. 应用插件开发：为第三方应用提供音乐控制模块

普通用户场景

4. 语音控制：通过 Claude 自然语言指令管理音乐播放
5. 场景化播放：设置"工作模式"等场景自动切换播放列表

实践指南：从零开始的配置之旅

准备工作

1. 注册 Spotify 开发者账号并创建应用
2. 获取 Client ID 和 Client Secret
3. 克隆项目代码：git clone https://gitcode.com/gh_mirrors/sp/spotify-mcp

核心配置（三步完成授权）

1. 编辑 config.json 文件，填入 API 凭证

   {
     "client_id": "YOUR_CLIENT_ID",
     "client_secret": "YOUR_CLIENT_SECRET",
     "redirect_uri": "http://localhost:8888/callback"
   }
   

2. 安装依赖：pip install -r requirements.txt
3. 启动服务：python src/spotify_mcp/server.py

进阶技巧

• 日志调试：通过 --debug 参数启用详细日志
• 自定义指令：修改 server.py 扩展命令处理逻辑
• 开机自启：配置系统服务实现后台运行

通过 spotify-mcp，用户可将 Claude 转变为智能音乐控制中枢，实现从指令到播放的无缝衔接。无论是开发者构建音乐应用，还是普通用户享受语音控制便利，该项目都提供了可靠的技术支撑和灵活的扩展能力。