Spotify播放列表管理服务

通过集成Spotify API,提供音乐搜索、播放列表创建与管理、音乐推荐等功能。

  • by richbai90
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 richbai90/spotify-mcp

使用说明

Spotify的MCP服务器

此MCP服务器与Spotify API集成,允许您通过Claude管理和创建播放列表。

特性

  • 搜索曲目、艺术家和专辑
  • 创建和修改播放列表
  • 浏览用户播放列表
  • 获取基于曲目、艺术家和流派的推荐

身份验证设置

  1. 在中创建Spotify应用程序 Spotify开发者仪表板
  2. 将重定向URI设置为 http://localhost:8888/callback
  3. 使用附带的身份验证应用程序获取刷新令牌:
# Go to the auth-app directory
cd auth-app

# Install dependencies
npm install

# Run the auth app
npm start
  1. 按照浏览器中的说明授权并获取刷新令牌

  2. 设置所需的环境变量:

export SPOTIFY_CLIENT_ID="your-client-id"
export SPOTIFY_CLIENT_SECRET="your-client-secret"
export SPOTIFY_REFRESH_TOKEN="your-refresh-token"

运行服务器

一旦你有了所需的环境变量,你就可以运行服务器了:

# From the root directory
npm install
npm run build
node dist/index.js

Docker使用

您还可以使用Docker构建和运行服务器:

# Build the Docker image
podman build -t mcp/spotify -f src/spotify/Dockerfile .

# Run the container with environment variables
podman run -e SPOTIFY_CLIENT_ID="your-client-id" \
  -e SPOTIFY_CLIENT_SECRET="your-client-secret" \
  -e SPOTIFY_REFRESH_TOKEN="your-refresh-token" \
  mcp/spotify

与Claude一起使用

将以下内容添加到服务器配置中


{
  "mcpServers": {
    "spotify": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOTIFY_CLIENT_ID=your-client-id",
        "-e",
        "SPOTIFY_CLIENT_SECRET=your-client-secret",
        "-e",
        "SPOTIFY_REFRESH_TOKEN=your-refresh-token",
        "mcp/spotify"
      ]
    }
  }
}

提示

一旦MCP服务器运行,Claude就可以利用它来:

  1. 在Spotify上搜索音乐
  2. 根据主题或流派创建播放列表
  3. 将曲目添加到播放列表
  4. 探索您现有的播放列表
  5. 根据您的音乐偏好获取推荐

只需要求Claude创建播放列表或查找音乐,它就会通过MCP服务器使用适当的Spotify API工具。