Vulpes Spotify MCP Server

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を再起動してください。

ライセンス

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