Skip to main content
Glama
Spotify MCP Server

Spotify MCP Server

by g2dgaming

spotify-mcp MCP 서버

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

특징

  • 재생 시작, 일시 정지 및 건너뛰기

  • 트랙/앨범/아티스트/재생목록 검색

  • 트랙/앨범/아티스트/재생목록에 대한 정보 얻기

  • Spotify 대기열 관리

  • 재생목록 관리, 생성 및 업데이트

Related MCP server: Spotify MCP Server

데모

오디오를 켜두세요

구성

Spotify API 키 받기

developer.spotify.com 에서 계정을 만드세요. 대시 보드 로 이동하세요. 리디렉션 URI를 http://127.0.0.1:8080/callback 으로 설정하여 앱을 만드세요. 원하는 포트를 선택할 수 있지만 http와 명시적인 루프백 주소(IPv4 또는 IPv6)를 사용해야 합니다.

자세한 정보/문제 해결 방법은 여기를 참조하세요. MCP 환경(예: Claude Desktop)을 한두 번 다시 시작해야 제대로 작동할 수 있습니다.

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

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

지엑스피1

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

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

Windows의 Claude Desktop: %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://127.0.0.1:8080/callback"
    }
  }

문제 해결

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

  1. uv 최신 상태인지 확인하세요. >=0.54 버전을 권장합니다.

  2. 클로드에게 프로젝트에 대한 실행 권한이 있는지 확인하세요: chmod -R 755 .

  3. 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 지원 추가.

PR 감사합니다! 기여해주신 @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj 및 기타 분들께 감사드립니다.

전개

(할 일)

건축 및 출판

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

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

uv sync
  1. 패키지 배포 빌드:

uv build

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

  1. PyPI에 게시:

uv publish

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

  • 토큰: --token 또는 UV_PUBLISH_TOKEN

  • 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

Available Tools

5 tools
SpotifyGetInfoA

Get detailed information about a Spotify item (track, album, artist, or playlist).

Inputs: item_uri (required).

SpotifyPlaybackB

Manages the current playback with the following actions: - get: Get information about user's current track. - start: Starts playing new item or resumes current playback if called with no uri. - pause: Pauses current playback. - skip: Skips current track.

Inputs: action (required), num_skips, spotify_uri.

SpotifyPlaylistC

Manage Spotify playlists. - get: Get a list of user's playlists. - get_tracks: Get tracks in a specific playlist. - add_tracks: Add tracks to a specific playlist. - remove_tracks: Remove tracks from a specific playlist. - change_details: Change details of a specific playlist.

Inputs: action (required), description, name, playlist_id, +1 more.

SpotifyQueueB

Manage the playback queue - get the queue or add tracks.

Inputs: action (required), track_id.

SpotifySearchB

Search for tracks, albums, artists, or playlists on Spotify.

Inputs: query (required), limit, qtype.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: SpotifyGetInfo retrieves metadata, SpotifyPlayback handles real-time playback control, SpotifyPlaylist manages playlist content and details, SpotifyQueue manages the playback queue, and SpotifySearch performs searches. There is no overlap in functionality that would cause confusion.

    Naming Consistency5/5

    All tool names follow a consistent 'Spotify' prefix with a descriptive noun or verb-noun pattern (e.g., SpotifyGetInfo, SpotifyPlayback, SpotifyPlaylist, SpotifyQueue, SpotifySearch). This uniformity makes the tool set predictable and easy to navigate.

    Tool Count5/5

    With 5 tools, the server is well-scoped for managing Spotify interactions, covering key areas like playback, playlists, search, queue, and general info. Each tool earns its place without feeling bloated or insufficient for the domain.

    Completeness4/5

    The tool set provides comprehensive coverage for core Spotify operations, including CRUD for playlists, playback control, search, and queue management. A minor gap is the lack of user profile or library management tools (e.g., managing saved tracks or albums), but agents can still handle most common workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers