local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables searching for tracks, viewing Spotify profiles, creating and managing playlists, adding tracks to playlists, and getting personalized music recommendations using a Spotify account.

Spotify MCP 서버

Claude를 통해 Spotify와 상호작용할 수 있는 간단한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 Claude는 Spotify 계정을 사용하여 노래를 검색하고, 플레이리스트를 만들고, 추천을 받는 등의 작업을 할 수 있습니다.

특징

Spotify에서 트랙 검색
Spotify 프로필 보기
재생목록 만들기
재생 목록에 트랙 추가
개인화된 음악 추천을 받으세요

사용 가능한 도구

도구 이름	설명
`set-spotify-credentials`	Spotify 인증 자격 증명을 설정하세요
`check-credentials-status`	귀하의 자격 증명이 유효한지, 누가 로그인했는지 확인하세요.
`search-tracks`	이름, 아티스트 또는 키워드로 트랙 검색
`get-current-user`	Spotify 프로필 정보 받기
`create-playlist`	계정에 새 재생 목록을 만듭니다
`add-tracks-to-playlist`	기존 재생 목록에 트랙 추가
`get-recommendations`	시드 트랙을 기반으로 추천을 받으세요

설치 지침

1. 필수 조건

Node.js v16 이상
엔피엠
Spotify 계정
등록된 Spotify 개발자 애플리케이션

2. Spotify 개발자 앱 만들기

Spotify 개발자 대시보드 로 이동
Spotify 계정으로 로그인하세요
"앱 만들기"를 클릭하세요
앱 이름과 설명을 입력하세요
http://localhost:8888/callback 리디렉션 URI로 추가합니다.
클라이언트 ID와 클라이언트 비밀번호를 기록해 두세요.

3. 프로젝트 설치

지엑스피1

4. Spotify 토큰 받기

spotify-auth.js 파일을 편집하여 클라이언트 ID와 클라이언트 비밀번호를 포함하세요.

// Replace these with your Spotify app credentials
const CLIENT_ID = "your_client_id_here";
const CLIENT_SECRET = "your_client_secret_here";

그런 다음 인증 스크립트를 실행합니다.

node spotify-auth.js

이렇게 하면:

브라우저에서 URL을 엽니다
Spotify에 로그인하라는 메시지가 표시됩니다.
귀하의 계정에 액세스할 수 있는 권한을 요청하세요
토큰을 secrets.json 에 저장합니다.

5. MCP 서버 구축

npm run build

6. Claude Desktop 구성

Claude Desktop 구성 파일을 편집하세요.

macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

다음 구성을 추가합니다.

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/full/path/to/spotify-mcp-server/build/spotify-mcp-server.js"]
    }
  }
}

/full/path/to/spotify-mcp-server 프로젝트 디렉토리의 실제 경로로 바꾸세요.

7. Claude Desktop을 다시 시작하세요

Claude Desktop을 닫았다가 다시 열어서 새로운 구성을 로드합니다.

용법

클로드와 대화를 시작하려면 먼저 Spotify 자격 증명을 설정해야 합니다.

자격 증명을 얻으려면 secrets.json 파일을 확인하세요.
set-spotify-credentials 도구를 사용하여 인증하세요
그런 다음 다른 Spotify 도구를 사용하세요.

예시 프롬프트

자격 증명 설정

I want to connect to my Spotify account. Here are my credentials from secrets.json:

Tool: set-spotify-credentials
Parameters:
{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "accessToken": "your_access_token",
  "refreshToken": "your_refresh_token"
}

기본 명령

계정을 확인하세요:

Can you check who I'm logged in as on Spotify?

Tool: get-current-user
Parameters: {}

트랙 검색:

Search for songs by Weekend

Tool: search-tracks
Parameters:
{
  "query": "Taylor Swift",
  "limit": 5
}

재생목록 만들기:

Create a new playlist called "My Pretty pretty girlfriend"

Tool: create-playlist
Parameters:
{
  "name": "My Pretty pretty girlfriend",
  "description": "For my girlfriend. Created with Claude and the Spotify MCP server"
}

다단계 작업

노래로 플레이리스트 만들기:

I want to create a workout playlist with energetic songs. First, search for some high-energy songs. Then create a playlist called "Workout Mix" and add those songs to it.

즐겨찾기를 기반으로 추천 받기:

I like the song "Blinding Lights" by The Weeknd. Can you search for it, then find similar songs, and create a playlist with those recommendations?

문제 해결

오류: 사용 가능한 액세스 토큰이 없습니다 . set-spotify-credentials 도구를 사용하여 먼저 자격 증명을 설정해야 합니다.
인증 실패 : 토큰이 만료되었을 수 있습니다. 인증 스크립트를 다시 실행하여 새 토큰을 받으세요.
잘못된 자격 증명 : 올바른 클라이언트 ID와 클라이언트 비밀번호를 사용하고 있는지 다시 한 번 확인하세요.

노트

서버는 자격 증명을 메모리에만 저장합니다.
새로운 대화를 시작할 때마다 자격 증명을 설정해야 합니다.
Claude Desktop이 다시 시작되면 자격 증명을 다시 설정해야 합니다.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Claude가 Spotify 계정을 통해 노래 검색, 재생 목록 생성, 추천 받기, 음악 관리 등을 통해 Spotify와 상호 작용할 수 있도록 합니다.

Appeared in Searches

Microsoft Outlook Application or Email Service