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使用など）向けに設定されていません。このリポジトリをクローンしてローカルで実行してください。

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

MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

トラブルシューティング

このMCPが動作しない場合は、問題を報告してください。以下にヒントをいくつか示します。

1. uvが更新されていることを確認してください。バージョン>=0.54推奨します。

2. claude にプロジェクトの実行権限があることを確認します: chmod -R 755 。

3. Spotify Premium があることを確認します (開発者 API を実行するために必要)。

やるべきこと

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

• テスト。

• プレイリストを管理するための API サポートを追加します。

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

展開

（やること）

建築と出版

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

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

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

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

3. PyPI に公開:

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

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

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

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

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

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