Vuples Spotify MCP サーバー

Claude のような AI アシスタントが Spotify と対話してトラックを検索したり再生したりできるようにする Model Context Protocol (MCP) サーバー。

特徴

• アーティスト、タイトル、または任意のクエリでトラックを検索します

• アクティブなSpotifyデバイスでトラックを直接再生します

• 現在再生中のトラックに関する情報を取得します

• 利用可能なSpotify再生デバイスを見つける

• 検索と再生機能を組み合わせた

• ユーザーのSpotifyプレイリストを一覧表示する

• プレイリスト内のトラックを表示する

• プレイリストを再生する（オプションでシャッフルモードも利用可能）

• 名前でプレイリストを検索して再生する

要件

• Node.js (v16+)

• Spotify開発者アカウント

• Spotify Premiumアカウント（再生機能用）

• MCP 互換クライアント (例: Claude Desktop)

インストール

1. このリポジトリをクローンします:

   git clone https://github.com/yourusername/spotify-mcp.git cd spotify-mcp

2. 依存関係をインストールします:

   npm install

3. Spotify API 資格情報を使用して.envファイルを作成します。

   SPOTIFY_CLIENT_ID=your_client_id SPOTIFY_CLIENT_SECRET=your_client_secret SPOTIFY_REDIRECT_URI=http://localhost:8888 # Optional: For playback control SPOTIFY_REFRESH_TOKEN=your_refresh_token

   Spotify 開発者ダッシュボードからクライアント ID とシークレットを取得できます。

4. リフレッシュ トークンを生成します (再生制御に必要)。

   リフレッシュ トークンを取得するには、次の 2 つの方法があります。

   オプション1: 組み込みスクリプトを使用する

   npm run get-token

   これにより、ローカル サーバーが起動し、ターミナルに指示が表示されます。

   オプション 2: シンプルなスクリプトを使用する (オプション 1 が機能しない場合)

   node src/simple-auth.js

   ブラウザで開くためのURLが表示されます。承認後、URLにリダイレクトされます。そのURLをターミナルにコピーすると、リフレッシュトークンを取得するためのcurlコマンドが表示されます。

   必要なスコープ (スクリプトにすでに含まれています):

   • user-read-playback-state

   • user-modify-playback-state

   • user-read-currently-playing

   • playlist-read-private

   • playlist-read-collaborative

5. リフレッシュ トークンを.envファイルに追加します。

   SPOTIFY_REFRESH_TOKEN=your_refresh_token

6. プロジェクトをビルドします。

   npm run build

Claude Desktopでの使用

1. まず、Spotifyがデバイス上で開いて再生されていることを確認してください

2. このサーバーを Claude Desktop 構成に追加します。

   claude_desktop_config.jsonファイルを編集します (通常、macOS では~/Library/Application Support/Claude/ 、Windows では%APPDATA%\\Claude\\にあります)。

   { "mcpServers": { "spotify": { "command": "node", "args": ["/absolute/path/to/vulpes-spotify-mcp/dist/index.js"], "env": { "SPOTIFY_CLIENT_ID": "your_client_id", "SPOTIFY_CLIENT_SECRET": "your_client_secret", "SPOTIFY_REDIRECT_URI": "http://localhost:8888", "SPOTIFY_REFRESH_TOKEN": "your_refresh_token" } } } }

   /absolute/path/to/vulpes-spotify-mcpプロジェクトへの実際のパスに置き換えてください。

3. Claudeデスクトップを再起動します

4. Claude Desktopのハンマーアイコンをクリックすると、Spotifyツールが利用可能になるはずです。

利用可能なツール

• spotify-search : クエリでトラックを検索

• spotify-play : IDまたはURIで特定のトラックを再生する

• spotify-currently-playing : 現在再生中のトラックに関する情報を取得します

• spotify-devices : 利用可能なSpotify再生デバイスを一覧表示します

• spotify-search-and-play : トラックを検索し、上位の結果を自動的に再生します

• spotify-playlists : ユーザーのSpotifyプレイリストのリストを取得します

• spotify-playlist-tracks : 特定のプレイリストからトラックを取得する

• spotify-play-playlist : 特定のプレイリストを再生する（シャッフルも選択可能）

• spotify-find-playlist : 名前でプレイリストを検索して再生します（AI での使用に推奨）

トラブルシューティング

• 「アクティブなデバイスが見つかりません」 : 少なくとも 1 つのデバイスで Spotify が開いて再生されていることを確認してください

• 「権限がありません」 : リフレッシュトークンに必要なスコープがない可能性があります

• 「プレミアムではありません」 : 再生コントロールにはSpotifyプレミアムアカウントが必要です

• 「リフレッシュトークンの問題」 : トークンの有効期限が切れた場合は、インストールセクションの手順に従って新しいトークンを生成してください。

重要な注意事項

1. 再生コントロールを使用する前に、少なくとも 1 つのデバイスで Spotify が開いていることを確認してください。

2. .envファイルとClaude Desktop構成の更新トークンが一致している必要があります

3. 設定を変更したら、Claude Desktopを再起動してください。

ライセンス

マサチューセッツ工科大学