local-only server

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

Integrations

Allows control of Spotify playback including play, pause, skip functions, search for tracks/albums/artists/playlists, get information about Spotify content, and manage the Spotify queue

spotify-mcp MCP 서버

Claude와 Spotify를 연결하는 MCP 프로젝트입니다. spotipy-dev의 API를 기반으로 구축되었습니다.

특징

재생 시작, 일시 정지 및 건너뛰기
트랙/앨범/아티스트/재생목록 검색
트랙/앨범/아티스트/재생목록에 대한 정보 얻기
Spotify 대기열 관리

데모

오디오를 켜두세요

구성

Spotify API 키 받기

developer.spotify.com 에서 계정을 만드세요. 대시보드 로 이동하세요. 'redirect_uri'를 http://localhost:8888 로 설정하여 앱을 만드세요. (원하는 포트를 선택할 수 있지만 http와 localhost를 사용해야 합니다.) 저는 "사용되는 API"를 "웹 재생 SDK"로 설정했습니다.

이 프로젝트를 로컬로 실행하세요

이 프로젝트는 아직 임시 환경(예: uvx 사용)에 맞게 설정되지 않았습니다. 이 저장소를 복제하여 로컬에서 프로젝트를 실행하세요.

지엑스피1

이 도구를 mcp 서버로 추가합니다.

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

"spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify_mcp",
      "run",
      "spotify-mcp"
    ],
    "env": {
      "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
      "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
      "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
    }
  }

문제 해결

이 MCP가 작동하지 않으면 문제를 제기해 주세요. 몇 가지 팁을 알려드리겠습니다.

uv 최신 상태인지 확인하세요. >=0.54 버전을 권장합니다.
클로드에게 프로젝트에 대한 실행 권한이 있는지 확인하세요: chmod -R 755 .
Spotify 프리미엄이 있는지 확인하세요(개발자 API를 실행하는 데 필요).

이 MCP는 MCP 사양에 명시된 대로 std err에 로그를 출력합니다. Mac에서는 Claude Desktop 앱이 이 로그를 ~/Library/Logs/Claude 에 출력해야 합니다. 다른 플랫폼에서는 여기에서 로그를 확인할 수 있습니다 .

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

할 일

안타깝게도 Spotify API에서 여러 가지 멋진 기능이 지원 중단되었습니다 . 대부분의 새로운 기능은 비교적 사소하거나 프로젝트 운영에 도움이 될 것입니다.

테스트.
재생목록 관리를 위한 API 지원 추가.
페이지별 검색 결과/재생 목록/앨범에 대한 API 지원 추가.

홍보 부탁드립니다!

전개

(할 일)

건축 및 출판

배포를 위해 패키지를 준비하려면:

종속성 동기화 및 잠금 파일 업데이트:

uv sync

패키지 배포 빌드:

uv build

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

PyPI에 게시:

uv publish

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

토큰: --token 또는 UV_PUBLISH_TOKEN
또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Claude와 Spotify를 연결하는 서버로, 사용자는 재생을 제어하고, 콘텐츠를 검색하고, 트랙/앨범/아티스트/재생 목록에 대한 정보를 얻고, Spotify 대기열을 관리할 수 있습니다.

Related Resources

Reddit Discussion about this server

Spotify MCP Server