marcelmarais/spotify-mcp-server

스포티파이 MCP 서버

Cursor와 Claude 같은 AI 어시스턴트가 Spotify 재생을 제어하고 재생목록을 관리할 수 있도록 하는 경량 모델 컨텍스트 프로토콜(MCP) 서버입니다.

목차

• 상호작용 예시
• 도구
• 리드 오퍼레이션
• 앨범 운영
• 연산 재생 / 생성
• 플레이리스트 운영
• 설치
• 선수 조건
• 설치
• Spotify 개발자 애플리케이션 생성
• Spotify API 구성
• 인증 과정
• Claude 데스크톱, 커서, VsCode(Cline) 통합
• 스트리밍 가능한 HTTP
• OAuth (MCPHub 및 기타 OAuth 지원 클라이언트)
• 도커 (MCPHub에 권장)

상호작용 예시

• “엘비스의 첫 노래를 틀어줘”
• “테일러 스위프트 / 슬립낫 퓨전 플레이리스트 만들기”
• “내 운동 재생목록에서 모든 테크노 트랙을 내 작업 재생목록으로 복사해”
• “볼륨 좀 줄여줘”

도구

작전 읽기

1. 스포티파이 검색

• 설명: 스포티파이에서 트랙, 앨범, 아티스트 또는 플레이리스트를 검색하세요
• 매개변수:
• query (문자열): 검색어
• type (문자열): 검색할 항목 유형 (트랙, 앨범, 아티스트, 플레이리스트)
• limit (번호, 선택 사항): 최대 반환 결과 수 (1-10, 기본값: 10)

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.

Example Interactions

• “Play Elvis’s first song”
• “Create a Taylor Swift / Slipknot fusion playlist”
• “Copy all the techno tracks from my workout playlist to my work playlist”
• “Turn the volume down a bit”

Tools

Read Operations

1. searchSpotify

   • Description: Search for tracks, albums, artists, or playlists on Spotify
   • Parameters:
     • query (string): The search term
     • type (string): Type of item to search for (track, album, artist, playlist)
     • limit (number, optional): Maximum number of results to return (1-10, default: 10)
     • offset (number, optional): Index of the first result to return (default: 0)
   • Returns: List of matching items with their IDs, names, and additional details
   • Example: searchSpotify("bohemian rhapsody", "track", 10)

2. getNowPlaying

   • Description: Get information about the currently playing track on Spotify, including device and volume info
   • Parameters: None
   • Returns: Object containing track name, artist, album, playback progress, duration, playback state, device info, volume, and shuffle/repeat status
   • Example: getNowPlaying()

3. getMyPlaylists

   • Description: Get a list of the current user’s playlists on Spotify
   • Parameters:
     • limit (number, optional): Maximum number of playlists to return (default: 20)
     • offset (number, optional): Index of the first playlist to return (default: 0)
   • Returns: Array of playlists with their IDs, names, track counts, and public status
   • Example: getMyPlaylists(10, 0)

4. getPlaylistTracks