关键词

Spotify音乐控制播放列表管理AI助手音乐工具

使用说明

项目简介

Spotify MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为AI助手（如Cursor和Claude）提供与Spotify音乐平台交互的能力。通过此服务器，用户可以使用自然语言命令，让AI助手控制Spotify的播放、搜索音乐、管理播放列表等。

主要功能点

  • 音乐搜索: 通过关键词搜索Spotify上的歌曲、专辑、艺术家或播放列表。
  • 播放控制: 控制Spotify的音乐播放，包括播放指定歌曲、专辑、艺术家或播放列表，暂停、跳到下一首/上一首。
  • 播放列表管理: 创建新的播放列表，并将歌曲添加到指定播放列表。
  • 当前播放信息: 获取当前Spotify正在播放的歌曲信息。
  • 用户播放列表: 获取用户在Spotify上的所有播放列表。
  • 播放列表歌曲: 获取指定播放列表中的所有歌曲。

安装步骤

  1. 安装Node.js: 确保你的电脑上已安装Node.js v16或更高版本。
  2. 克隆仓库: 使用Git克隆GitHub仓库到本地： 
    git clone https://github.com/marcelmarais/spotify-mcp-server.git
cd spotify-mcp-server
  3. 安装依赖: 在项目目录下运行npm安装命令： 
    npm install
  4. 构建项目: 运行npm构建命令编译TypeScript代码： 
    npm run build
  5. 创建Spotify应用: 访问 Spotify开发者仪表板，创建一个新的应用，并获取 Client ID 和 Client Secret。在应用设置中，添加一个 Redirect URI，例如 'http://localhost:8888/callback'。
  6. 配置Spotify API: 复制 'spotify-config.example.json' 文件并重命名为 'spotify-config.json'，然后编辑该文件，填入你的 Client ID、Client Secret 和 Redirect URI。
  7. Spotify授权: 运行授权脚本，完成Spotify账户的授权流程： 
    npm run auth
    按照提示在浏览器中完成Spotify登录和授权。授权成功后，访问令牌和刷新令牌将自动保存到 'spotify-config.json' 文件中。
  8. 启动服务器: 运行以下命令启动MCP服务器： 
    npm run start
    或直接运行构建后的index.js文件： 
    node build/index.js

服务器配置 (MCP客户端)

要将此MCP服务器连接到MCP客户端（例如Cursor或Claude），您需要配置客户端以启动服务器进程。以下是配置示例，您需要将其添加到您的MCP客户端配置中。

Cursor 配置示例 (Cursor Settings -> MCP):

{
  "server name": "spotify",
  "command": "node",
  "args": ["path/to/spotify-mcp-server/build/index.js"]
}

Claude Desktop 配置示例 (Claude 配置文件):

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["path/to/spotify-mcp-server/build/index.js"]
    }
  }
}

注意:

  • '"server name"': 您可以自定义服务器名称，例如 "spotify"。
  • '"command"': 指定启动服务器的命令，这里是 'node'。
  • '"args"': 一个字符串数组，包含传递给命令的参数。这里指向构建后的 'index.js' 文件路径。 请将 '"path/to/spotify-mcp-server"' 替换为您的 'spotify-mcp-server' 项目在您电脑上的实际路径。 例如，如果您的项目在用户目录下的 'Documents/spotify-mcp-server'，则路径可能类似于 '/Users/yourusername/Documents/spotify-mcp-server/build/index.js'。

基本使用方法

启动服务器并在MCP客户端中配置完成后，您就可以在客户端中使用自然语言指令来控制Spotify了。例如，在Cursor或Claude中，您可以输入以下指令：

  • "在Spotify上播放 Bohemian Rhapsody"
  • "搜索Taylor Swift的专辑"
  • "创建一个名为'工作音乐'的Spotify播放列表"
  • "暂停Spotify播放"
  • "我的Spotify播放列表有哪些？"

AI助手会将这些指令转换为对Spotify MCP服务器的请求，服务器会调用相应的Spotify API功能并返回结果。

信息

分类

生产力应用

访问项目