@striderlabs/mcp-spotify

Spotify용 MCP 서버 — AI 에이전트가 Spotify Web API를 통해 음악을 검색하고, 재생을 제어하고, 플레이리스트를 관리할 수 있게 해줍니다.

Strider Labs에서 만들었습니다.

기능

• 검색 — 트랙, 아티스트, 앨범, 플레이리스트 찾기

• 플레이리스트 — 플레이리스트 보기, 만들기, 편집

• 재생 제어 — 재생, 일시정지, 건너뛰기, 이전 곡, 볼륨 설정

• 멀티 디바이스 — Spotify Connect 기기 목록 확인 및 전환

• OAuth 2.0 — PKCE 기반 안전한 인증 (클라이언트 시크릿 불필요)

• 토큰 지속성 — 토큰을 로컬에 저장하고 자동으로 갱신

Related MCP server: Spotify MCP Server

설정

1. Spotify 앱 만들기

1. Spotify Developer Dashboard로 이동합니다.

2. Create App을 클릭합니다.

3. Redirect URI를 http://localhost:8888/callback(으)로 설정합니다.

4. Client ID를 복사합니다.

2. 설치

npx @striderlabs/mcp-spotify

또는 전역으로 설치합니다:

npm install -g @striderlabs/mcp-spotify

3. Claude Desktop 설정

claude_desktop_config.json에 다음을 추가합니다:

{
  "mcpServers": {
    "spotify": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-spotify"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here"
      }
    }
  }
}

4. 인증

Claude에서 인증 도구를 한 번 호출합니다:

spotify_auth

브라우저 창이 열리면 액세스를 승인하세요. 승인 후 토큰은 ~/.striderlabs/spotify/tokens.json에 로컬로 저장되며 자동으로 갱신됩니다.

환경 변수

도구

인증

검색

플레이리스트

재생

예시 워크플로

1. spotify_status            → check if authenticated
2. spotify_auth              → open browser to authorize (first time)
3. search_tracks query="Bohemian Rhapsody"
4. get_devices               → list available devices
5. play uris=["spotify:track:..."] deviceId="..."
6. get_currently_playing     → see what's playing
7. set_volume volumePercent=70
8. next_track                → skip to next
9. get_playlists             → see your playlists
10. create_playlist name="AI Picks"
11. add_to_playlist playlistId="..." uris=["spotify:track:..."]

요구 사항

• Node.js 18+

• Spotify 계정 (Free 또는 Premium)

• 볼륨 제어 및 재생 제어에는 Spotify Premium 필요

기술 세부 사항

• 프로토콜: stdio 기반 Model Context Protocol (MCP)

• 인증: PKCE를 사용한 OAuth 2.0 Authorization Code

• API: Spotify Web API v1

• 토큰 저장: ~/.striderlabs/spotify/tokens.json

• 브라우저 자동화: Playwright (OAuth 브라우저 실행용)

라이선스

MIT — Strider Labs