Spotify MCP Server

Spotify MCP Server

site icon
2025.03.18 0
Python音乐播放控制Spotify 集成娱乐功能
Spotify-MCP-Server 是一个基于 Flask 的 MCP 服务器,集成了 Spotify Web API,用于控制音乐播放、管理音量、获取播放列表等功能。
View on GitHub

Overview

基本能力

产品定位

Spotify-MCP-Server 是一个用于控制 Spotify 音乐播放的中间件服务,提供了一系列与 Spotify 交互的 API 接口。

核心功能

  • 与 Spotify 进行身份验证
  • 控制播放(播放/暂停/下一首/上一首)
  • 调整音量
  • 获取当前播放的歌曲信息
  • 获取用户播放列表
  • 执行 MCP 命令(用于自定义命令)

适用场景

  • 个人音乐播放控制
  • 自动化音乐播放管理
  • 集成到智能家居系统中控制音乐播放

工具列表

  • /login: 重定向到 Spotify 进行身份验证
  • /callback: 处理 Spotify OAuth 回调
  • /current-song: 获取当前播放的歌曲
  • /play: 开始播放
  • /pause: 暂停播放
  • /next: 跳到下一首
  • /previous: 返回上一首
  • /volume?volume=50: 设置音量(50 可替换为其他值)
  • /playlists: 获取用户播放列表
  • /mcp-command?command=play: 执行 MCP 命令

常见问题解答

暂无提供。

使用教程

使用依赖

需要安装 Python 和 Flask 框架。

pip install flask
pip install requests

安装教程

  1. 克隆项目仓库
git clone <repository-url>
cd Spotify-MCP-Server
  1. 安装依赖
pip install -r requirements.txt
  1. 运行服务器
python app.py

调试方式

启动服务器后,可以使用以下命令测试 API 是否正常工作:

curl http://localhost:5000/current-song

许可证

None