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」を「Web Playback SDK」に設定しました。

このプロジェクトをローカルで実行する

このプロジェクトはまだ一時的な環境（ uvx使用など）向けに設定されていません。このリポジトリをクローンしてローカルで実行してください。

git clone https://github.com/varunneal/spotify-mcp.git

このツールを 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推奨します。
claude にプロジェクトの実行権限があることを確認します: chmod -R 755 。
Spotify Premium があることを確認します (開発者 API を実行するために必要)。

このMCPは、MCP仕様で規定されているstd errにログを出力します。Macでは、Claudeデスクトップアプリはこれらのログを~/Library/Logs/Claudeに出力します。その他のプラットフォームでは、ログはここにあります。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

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

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

やるべきこと

残念ながら、Spotify API から多くの便利な機能が廃止されました。新しい機能のほとんどは、比較的マイナーなもの、またはプロジェクトの健全性に関するものです。

テスト。
プレイリストを管理するための API サポートを追加します。
ページ分割された検索結果/プレイリスト/アルバムの API サポートを追加します。

PRを歓迎します!

展開

（やること）

建築と出版

配布用のパッケージを準備するには:

依存関係を同期し、ロックファイルを更新します。

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