Spotify MCP Server

spotify-mcp MCP サーバー

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

特徴

• 再生を開始、一時停止、スキップする
• トラック/アルバム/アーティスト/プレイリストを検索
• トラック/アルバム/アーティスト/プレイリストに関する情報を取得する
• Spotifyキューを管理する
• プレイリストの管理、作成、更新

デモ

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

構成

Spotify APIキーの取得

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

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

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

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

このツールを MCP サーバーとして追加します。

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

Windows 上の Claude Desktop: %APPDATA%/Claude/claude_desktop_config.json

トラブルシューティング

この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 を起動できます。

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

やるべきこと

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

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

PR よろしくお願いします！ @jamiew、@davidpadbury、@manncodes、@hyuma7、@aanurraj などの貢献に感謝します。

展開

（やること）

建築と出版

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

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

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

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

3. PyPI に公開:

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

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