spotify

@striderlabs/mcp-spotify

Spotify 向け MCP サーバー — AI エージェントが Spotify Web API を使って、音楽を検索し、再生を操作し、プレイリストを管理できます。

Strider Labs が開発しました。

機能

• 検索 — トラック、アーティスト、アルバム、プレイリストを検索します
• プレイリスト — プレイリストの表示、作成、編集ができます
• 再生コントロール — 再生、一時停止、スキップ、前のトラックへの移動、音量の設定ができます
• マルチデバイス — Spotify Connect デバイスの一覧表示と切り替えができます
• OAuth 2.0 — PKCE による安全な認証（クライアントシークレットは不要です）
• トークンの永続化 — トークンはローカルに保存され、自動更新されます

セットアップ

1. Spotify アプリを作成する

1. Spotify Developer Dashboard にアクセスします
2. Create App をクリックします
3. Redirect URI に http://localhost:8888/callback を設定します
4. Client ID をコピーします

2. インストール

npx @striderlabs/mcp-spotify

または、グローバルにインストールします：

npm install -g @striderlabs/mcp-spotify

3. Claude Desktop を設定する

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "spotify": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-spotify"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here"
      }
    }
  }
}

4. 認証する

Claude で、認証ツールを一度呼び出します：

spotify_auth

認証を許可するためのブラウザーウィンドウが開きます。許可すると、トークンはローカルの ~/.striderlabs/spotify/tokens.json に保存され、自動更新されます。

環境変数

変数	必須	説明
SPOTIFY_CLIENT_ID	はい	Spotify アプリの Client ID

ツール

認証

ツール	説明
spotify_status	接続状態とログイン中のアカウントを確認します
spotify_auth	ブラウザーで認証します（OAuth 2.0 PKCE）
spotify_logout	保存されたトークンを消去します

検索

ツール	パラメーター	説明
search_tracks	query, limit?	曲を検索します
search_artists	query, limit?	アーティストを検索します
search_albums	query, limit?	アルバムを検索します
search_playlists	query, limit?	プレイリストを検索します

プレイリスト

ツール	パラメーター	説明
get_playlists	limit?	プレイリストを取得します
create_playlist	name, description?, public?	新しいプレイリストを作成します
add_to_playlist	playlistId, uris[], position?	トラックを追加します
remove_from_playlist	playlistId, uris[]	トラックを削除します

再生

ツール	パラメーター	説明
get_currently_playing	—	再生中のトラック、再生位置、デバイスを取得します
play	deviceId?, contextUri?, uris?[], offsetPosition?, positionMs?	再生を開始または再開します
pause	deviceId?	再生を一時停止します
next_track	deviceId?	次のトラックにスキップします
previous_track	deviceId?	前のトラックに戻ります
set_volume	volumePercent, deviceId?	音量を設定します（0–100）
get_devices	—	Spotify Connect デバイスを一覧表示します
transfer_playback	deviceId, play?	再生デバイスを切り替えます

ワークフローの例

1. spotify_status            → check if authenticated
2. spotify_auth              → open browser to authorize (first time)
3. search_tracks query="Bohemian Rhapsody"
4. get_devices               → list available devices
5. play uris=["spotify:track:..."] deviceId="..."
6. get_currently_playing     → see what's playing
7. set_volume volumePercent=70
8. next_track                → skip to next
9. get_playlists             → see your playlists
10. create_playlist name="AI Picks"
11. add_to_playlist playlistId="..." uris=["spotify:track:..."]

要件

• Node.js 18+
• Spotify アカウント（Free または Premium）
• 音量と再生の操作には Spotify Premium が必要です

技術詳細

• プロトコル：stdio を介した Model Context Protocol（MCP）
• 認証：PKCE を使用した OAuth 2.0 Authorization Code
• API：Spotify Web API v1
• トークンの保存先：~/.striderlabs/spotify/tokens.json
• ブラウザー自動化：Playwright（OAuth のブラウザー起動用）

ライセンス

MIT — Strider Labs