spotify-mcp MCP サーバー

ClaudeとSpotifyを接続するMCPプロジェクト。spotipy -devのAPIをベースに構築されています。

特徴

• 再生を開始、一時停止、スキップする

• トラック/アルバム/アーティスト/プレイリストを検索

• トラック/アルバム/アーティスト/プレイリストに関する情報を取得する

• Spotifyキューを管理する

• プレイリストの管理、作成、更新

Related MCP server: Spotify MCP Server

デモ

音声をオンにしてください

構成

Spotify APIキーの取得

developer.spotify.comでアカウントを作成してください。ダッシュボードに移動します。redirect_uri をhttp://127.0.0.1:8080/callbackに設定してアプリを作成します。任意のポートを選択できますが、http と明示的なループバックアドレス（IPv4 または IPv6）を使用する必要があります。

詳細情報/トラブルシューティングについては、こちらをご覧ください。動作確認前にMCP環境（例：Claude Desktop）を1～2回再起動する必要がある場合があります。

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

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

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

このツールを 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. claude にプロジェクトの実行権限があることを確認します: chmod -R 755 。

3. 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 よろしくお願いします！ @jamiew、@davidpadbury、@manncodes、@hyuma7、@aanurraj などの貢献に感謝します。

展開

（やること）

建築と出版

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

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

uv sync

2. パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

3. PyPI に公開:

uv publish

注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。

• トークン: --tokenまたはUV_PUBLISH_TOKEN

• またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• SpotifyGetInfoB
• SpotifyPlaybackA
• SpotifyPlaylistC
• SpotifyQueueB
• SpotifySearchC