marcelmarais/spotify-mcp-server

Spotify MCP 서버 – 개요

Spotify MCP 서버는 Spotify용 **Model Context Protocol(MCP)**을 구현하는 소형 Node.js 서비스입니다. AI 어시스턴트(Claude, Cursor, VS Code의 Cline 확장 프로그램 등)가 Spotify 계정과 통신할 수 있게 해줍니다: 현재 재생 중인 음악 조회, 카탈로그 검색, 재생 목록 읽기/편집, 재생 제어, 볼륨 조절 등 – 모두 MCP를 통해 노출되는 표준화된 "도구" 집합을 통해 가능합니다.

핵심 기능 (README에 설명된 대로)

카테고리	작업(예시)	기능
읽기	`searchSpotify`, `getNowPlaying`, `getMyPlaylists`, `getPlaylistTracks`, `getQueue`, `getAvailableDevices`	Spotify 카탈로그 검색, 현재 트랙 가져오기, 재생 목록 나열, 재생 대기열 확인, 연결된 기기 검색 등
재생 제어	`playMusic`, `pausePlayback`, `resumePlayback`, `skipToNext`, `skipToPrevious`, `addToQueue`, `setVolume`, `adjustVolume`	음악 시작/중지, 대기열 이동, 항목 추가, 볼륨 변경(Premium 필요).
앨범 처리	`getAlbums`, `getAlbumTracks`, `saveOrRemoveAlbumForUser`, `checkUsersSavedAlbums`	앨범 메타데이터 검색, 트랙 나열, 라이브러리에서 앨범 저장/제거.
재생 목록 처리	`createPlaylist`, `addTracksToPlaylist`, `removeTracksFromPlaylist`, `updatePlaylist`, `reorderPlaylistItems`	새 재생 목록 생성, 트랙 추가/삭제, 메타데이터 편집, 항목 재정렬.
사용자 라이브러리	`getUsersSavedTracks`, `removeUsersSavedTracks`, `getFollowedArtists`	"좋아요 표시한 노래" 및 팔로우한 아티스트 읽기/수정.

모든 도구는 AI가 직접 소비할 수 있는 구조화된 JSON(IDs, 이름, 상태 메시지)을 반환합니다.

실행 방법

사전 요구 사항 – Node v26+, Spotify Premium 계정, Spotify 개발자 앱.
설치 – 저장소를 클론하고 npm ci 실행 후 npm run build 실행.
Spotify 앱 만들기 – 클라이언트 ID/시크릿을 얻고 리디렉션 URI를 설정.
구성 – spotify-config.example.json을 spotify-config.json으로 복사하고 자격 증명을 입력.
인증 – npm run auth를 실행하여 OAuth 흐름을 완료; 토큰은 구성 파일에 저장되고 자동으로 갱신됩니다.
서버 시작 – node build/index.js(기본 stdio 전송) 또는 HTTP 기반 클라이언트의 경우 MCP_TRANSPORT=http 설정, 선택적으로 OAuth 보호 엔드포인트를 위해 MCP_AUTH=spotify 설정.

AI 도구와 함께 사용하기

Claude Desktop – 빌드된 index.js를 가리키는 MCP 항목 추가.
Cursor – 설정의 MCP 탭에 동일한 명령 추가.
VS Code Cline 확장 프로그램 – 서버 명령과 자동 승인된 도구를 나열하는 cline_mcp_settings.json 제공.

서버는 장기 실행 HTTP 프로세스(기본 포트 3000)로 실행될 수 있어 여러 클라이언트가 공유할 수 있습니다. MCP_AUTH=spotify가 설정되면 엔드포인트는 RFC 9728을 따르며, OAuth 인식 클라이언트가 Spotify 토큰을 직접 획득할 수 있어 개인 갱신 토큰이 서버에 노출되지 않습니다.

누가 유용하게 사용할 수 있나요?

AI 에이전트를 개발하는 개발자 – 더 넓은 워크플로우의 일부로 음악 재생을 제어해야 하는 경우(예: "코딩하는 동안 배경 음악 재생").
파워 유저 – LLM 기반 어시스턴트(Claude, Cursor)가 수동 클릭 없이 재생 목록을 관리하거나 현재 노래를 가져오도록 하려는 사용자.
실험가 – MCP를 통해 제3자 서비스를 LLM에 노출하는 방법을 탐구하는 사용자.

결론

Spotify MCP 서버는 Model Context Protocol과 Spotify Web API 사이의 진정한 오픈 소스 브리지로, AI 어시스턴트가 Spotify 계정을 프로그래밍 방식으로 읽고 조작할 수 있는 풍부한 도구 상자를 제공합니다. 완전히 문서화되어 있고 OAuth 처리를 포함하며, 로컬 또는 여러 클라이언트를 위한 HTTP 프록시 뒤에서 실행할 수 있습니다.

저장소: marcelmarais/spotify-mcp-server
라이선스/상태: README에 명시되지 않았지만, 프로젝트는 활발히 유지 관리되는 것으로 보입니다(빌드 스크립트, Docker 참고 사항, 통합 가이드).