Spotify MCP Server

关键词

Spotify控制音乐播放播放列表管理LLM工具音频服务

项目简介

Spotify MCP Server 是一个基于 Kotlin 开发的 Model Context Protocol (MCP) 服务器，它充当 LLM 客户端和 Spotify Web API 之间的桥梁。通过 MCP 协议，该服务器将 Spotify 的功能以标准化的工具形式暴露给 LLM，使得 LLM 能够控制音乐播放、管理用户的 Spotify 播放列表以及获取用户个人资料等信息。

主要功能点

  • Spotify 身份验证：处理 Spotify API 的身份验证和令牌管理。
  • 播放控制：提供播放、暂停、跳过曲目、调整音量、设置重复模式等音乐播放控制工具。
  • 播放列表管理：支持创建播放列表、添加/移除曲目、获取播放列表信息等播放列表管理工具。
  • 用户信息：允许 LLM 获取用户的 Spotify 个人资料信息。
  • MCP 集成：遵循 Model Context Protocol 协议，提供标准化的工具交互接口，易于与各种 MCP 客户端集成。

安装步骤

  1. 克隆仓库

    git clone https://github.com/Carrieukie/spotify-mcp-server.git
cd spotify-mcp-server

  2. 配置 Spotify API 凭据

    • 访问 Spotify Developer Dashboard，登录或注册 Spotify 开发者账号。
    • 创建一个新的应用，并记录下你的 Client ID 和 Client Secret。
    • 在项目根目录下创建 '.env' 文件，并填入你的 Spotify API 凭据： 
      SPOTIFY_CLIENT_ID = "你的 Client ID"
SPOTIFY_CLIENT_SECRET = "你的 Client Secret"

  3. 构建服务器

    ./gradlew installDist

    构建成功后，可执行文件位于 'build/install/kotlin-mcp-server/bin/kotlin-mcp-server'。

服务器配置

MCP 服务器需要 MCP 客户端通过配置连接才能使用，以下是 MCP 客户端（如 VS Code Copilot）连接 Spotify MCP Server 的配置示例 (JSON 格式)：

{
    "mcp": {
        "servers": {
            "spotify-mcp-server": {
                "command": "/path/to/your/spotify-mcp-server/build/install/kotlin-mcp-server/bin/kotlin-mcp-server", // 修改为服务器可执行文件的实际路径
                "args": [], // 启动参数，当前配置为空
                "env": {}
            }
        }
    }
}

注意：请将 'command' 字段的值 '/path/to/your/spotify-mcp-server/build/install/kotlin-mcp-server/bin/kotlin-mcp-server' 替换为你机器上 'kotlin-mcp-server' 可执行文件的实际路径。

基本使用方法

  1. 启动 MCP 服务器 在终端中执行以下命令启动服务器：

    /path/to/your/spotify-mcp-server/build/install/kotlin-mcp-server/bin/kotlin-mcp-server

    请将 '/path/to/your/spotify-mcp-server/build/install/kotlin-mcp-server/bin/kotlin-mcp-server' 替换为服务器可执行文件的实际路径。

  2. 配置 MCP 客户端 根据你的 MCP 客户端类型（如 VS Code Copilot），按照其文档配置服务器连接信息，通常需要填入上面提供的 JSON 配置。

  3. 通过 MCP 客户端与 Spotify 交互 连接成功后，你就可以在 MCP 客户端中使用自然语言指令或特定命令来控制 Spotify。例如，你可以让 LLM 播放指定的音乐、暂停播放、或者创建一个新的播放列表等。

服务器信息

访问项目