项目简介

Spotify MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端，专门用于将 Spotify 的核心功能以标准化的工具形式暴露给支持 MCP 的客户端，特别是大型语言模型 (LLM) 应用。通过此服务器，AI 助手等客户端可以无需了解复杂的 Spotify API 细节，即可轻松实现对 Spotify 音乐的搜索和播放控制。

主要功能点

本项目提供以下主要功能：

搜索音乐： 根据关键词查找 Spotify 上的歌曲。
播放控制： 支持播放、暂停、恢复播放、切换到下一首或上一首歌曲。
音量调整： 设置当前播放设备的音量。
获取信息： 查询当前播放的歌曲信息及当前用户的 Spotify 账户信息。
查看歌单： 获取当前用户的 Spotify 歌单列表。

这些功能都作为标准化的 MCP 工具提供。

安装步骤

克隆仓库： 首先，使用 Git 命令将项目仓库克隆到本地。

git clone https://github.com/KaanCL/Spotify-MCP-Server.git
cd Spotify-MCP-Server

设置Python环境： 项目推荐使用 'uv' 工具创建和管理虚拟环境及依赖。
```
uv venv
```
安装依赖： 使用 'uv sync' 命令安装项目所需的所有依赖库，包括 'fastapi'、'spotipy' 和 'mcp' 框架等。
```
uv sync
```

服务器配置 (为MCP客户端准备)

MCP 服务器通过特定的启动命令运行，供 MCP 客户端连接和交互。对于此 Spotify MCP 服务器，其服务器名称为 "SpotifyMCP"。MCP 客户端在配置时，通常需要指定启动服务器的命令及其参数。

服务器名称： 'SpotifyMCP'
启动命令 (Command)： 'uv'
启动参数 (Args)： '["run", "mcp", "install", "main.py"]'

这个配置告诉 MCP 客户端如何启动并连接到 Spotify MCP 服务器进程。

基本使用方法

成功安装并配置好 Spotify API 凭据（在项目目录下创建 '.env' 文件并填写 Spotify API 凭据）后，即可运行服务器：

uv run mcp install main.py

首次运行需要完成 Spotify 账号授权登录。服务器启动并监听连接后，任何兼容 MCP 的客户端（如 MCP 客户端库或集成了 MCP 功能的 AI 应用）即可通过调用服务器提供的工具来控制 Spotify。

例如，使用 MCP 客户端搜索歌曲和开始播放：

调用工具 'search'，参数 '{ "query": "歌曲名称" }'，获取搜索结果。
调用工具 'start_playback'，参数 '{ "track_name": "要播放的歌曲名称" }'，开始播放音乐。

客户端通过调用服务器暴露的具名工具（如 'search', 'start_playback', 'pause_playback' 等），并传入相应的参数，即可执行对应的 Spotify 操作。服务器会返回操作结果或错误信息。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (为MCP客户端准备)

基本使用方法

信息