GK

gupta-kush/spotify-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

10 stars 4 forks 质量 75 趋势 18MIT

Control Spotify from Claude, Cursor, or any MCP client. 100+ tools for playback, playlists, discovery, and curation.

概览

Control Spotify from Claude, Cursor, or any MCP client. for playback, search, playlist management, smart shuffle, vibe analysis, natural language song search, artist exploration, and library indexing. Just uvx spotify-mcp to get started. Go to the Spotify Developer Dashboard, create an app, set the redirect URI to http://127.0.0.1:8888/callback, check , and copy your . No client secret needed (PKCE auth). Then set your client ID: claude mcp add spotify -e SPOTIFY_CLIENT_ID=your_client_id -- uvx spotify-mcp (same config, but load only core tools to stay under the 40-tool limit): Or install with pip: pip install spotify-mcp The first time you use a Spotify tool, your browser opens for OAuth. Grant access and the token is cached locally. There are 30+ Spotify MCP servers out there. Most have 10-15 tools covering play, pause, and search.

README

以下为原文 README 节选,完整内容请查看原文。

Spotify MCP Server

Control Spotify from Claude, Cursor, or any MCP client. 100+ tools for playback, search, playlist management, smart shuffle, vibe analysis, natural language song search, artist exploration, and library indexing. Just uvx spotify-mcp to get started.

Quick Start

1. Get a Spotify Client ID

Go to the Spotify Developer Dashboard, create an app, set the redirect URI to http://127.0.0.1:8888/callback, check Web API, and copy your Client ID. No client secret needed (PKCE auth).

2. Install and Configure

Claude Code (one command):

claude mcp add spotify -- uvx spotify-mcp

Then set your client ID: claude mcp add spotify -e SPOTIFY_CLIENT_ID=your_client_id -- uvx spotify-mcp

Claude Desktop (add to claude_desktop_config.json):

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": ["spotify-mcp"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id"
      }
    }
  }
}

Cursor / VS Code (same config, but load only core tools to stay under the 40-tool limit):

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": ["spotify-mcp", "--toolsets=core"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id"
      }
    }
  }
}

Or install with pip: pip install spotify-mcp

3. Authorize

The first time you use a Spotify tool, your browser opens for OAuth. Grant access and the token is cached locally.

Why this one?

There are 30+ Spotify MCP servers out there. Most have 10-15 tools covering play, pause, and search.

spotify-mcp Typical server
Tools 100+ 5-15
Smart shuffle (6 strategies incl. energy arcs) Yes No
Vibe engine (mood analysis without audio-features) Yes No
Natural language song search Yes No
Artist network mapping (100 related artists) Yes No
Taste evolution tracking Yes No
Library index (AI playlists from your own songs) Yes No
Destructive tools stripped by default Yes No
在 GitHub 查看完整 README

安装

uvx spotify-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "spotify": { "command": "uvx", "args": ["spotify-mcp"], "env": { "SPOTIFY_CLIENT_ID": "your_client_id" } } } }