JinDaGe - mcp-server-for-spotify MCP Details

article

README

🚀 Spotify MCP 服务器

Spotify MCP 服务器与 Spotify API 集成，借助该服务器，您能够通过 Claude 便捷地管理和创建播放列表，轻松满足音乐管理需求。

✨ 主要特性

可搜索曲目、艺术家和专辑，快速定位心仪音乐。
支持创建和修改播放列表，随心定制专属歌单。
能浏览用户播放列表，回顾已有收藏。
可根据曲目、艺术家和流派获取推荐，发现更多好音乐。

📦 安装指南

认证设置

在 Spotify 开发者控制台创建一个 Spotify 应用。
将重定向 URI 设置为 http://localhost:8888/callback。
使用随附的认证应用程序获取您的刷新令牌：

# 进入 auth-app 目录
cd auth-app

# 安装依赖项
npm install

# 运行认证应用程序
npm start

在浏览器中按照说明授权并获取您的刷新令牌。
设置所需的环境变量：

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

运行服务器

设置好环境变量后，可以运行以下命令启动服务器：

# 从根目录
npm install
npm run build
node dist/index.js

Docker 使用

您也可以使用 Docker 构建并运行服务器：

# 构建 Docker 镜像
podman build -t mcp/spotify -f src/spotify/Dockerfile .

# 使用环境变量运行容器
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 可以利用它来：

在 Spotify 上搜索音乐。
根据主题或流派创建播放列表。
添加曲目到播放列表。
浏览您的现有播放列表。
获取基于您的音乐偏好的推荐。

只需让 Claude 创建一个播放列表或查找音乐，它将利用适当的 Spotify API 工具通过 MCP 服务器进行操作。

mcp-server-for-spotify