spotify-mcp MCP サーバー
ClaudeとSpotifyを接続するMCPプロジェクト。spotipy -devのAPIをベースに構築されています。
特徴
再生を開始、一時停止、スキップする
トラック/アルバム/アーティスト/プレイリストを検索
トラック/アルバム/アーティスト/プレイリストに関する情報を取得する
Spotifyキューを管理する
Related MCP server: Spotify MCP Server
デモ
音声をオンにしてください
構成
Spotify APIキーの取得
developer.spotify.comでアカウントを作成します。ダッシュボードに移動します。redirect_uri をhttp://localhost:8888にしてアプリを作成します。（任意のポートを選択できますが、http と localhost を使用する必要があります）。「使用する API」を「Web Playback SDK」に設定しました。
このプロジェクトをローカルで実行する
このプロジェクトはまだ一時的な環境（ uvx使用など）向けに設定されていません。このリポジトリをクローンしてローカルで実行してください。
このツールを MCP サーバーとして追加します。
MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
トラブルシューティング
このMCPが動作しない場合は、問題を報告してください。以下にヒントをいくつか示します。
uvが更新されていることを確認してください。バージョン>=0.54推奨します。claude にプロジェクトの実行権限があることを確認します:
chmod -R 755。Spotify Premium があることを確認します (開発者 API を実行するために必要)。
やるべきこと
残念ながら、Spotify API から多くの便利な機能が廃止されました。新しい機能のほとんどは、比較的マイナーなもの、またはプロジェクトの健全性に関するものです。
テスト。
プレイリストを管理するための API サポートを追加します。
ページ分割された検索結果/プレイリスト/アルバムの API サポートを追加します。
展開
（やること）
Smithery経由でインストール
Smithery経由で Claude Desktop 用の spotify-mcp を自動的にインストールするには:
建築と出版
配布用のパッケージを準備するには:
依存関係を同期し、ロックファイルを更新します。
パッケージディストリビューションをビルドします。
これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。
PyPI に公開:
注: 環境変数またはコマンドフラグを使用して PyPI 資格情報を設定する必要があります。
トークン:
--tokenまたはUV_PUBLISH_TOKENまたはユーザー名/パスワード:
--username/UV_PUBLISH_USERNAMEおよび--password/UV_PUBLISH_PASSWORD
デバッグ
MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。
次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。
起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。