@striderlabs/mcp-spotify

Spotify 用の MCP サーバー — AI エージェントが Spotify Web API 経由で音楽の検索、再生の制御、プレイリストの管理を行えるようにします。

Strider Labs によって構築されました。

機能

• 検索 — トラック、アーティスト、アルバム、プレイリストを検索

• プレイリスト — プレイリストの表示、作成、編集

• 再生コントロール — 再生、一時停止、スキップ、戻る、音量設定

• マルチデバイス — Spotify Connect デバイスの一覧表示と切り替え

• OAuth 2.0 — PKCE による安全な認可（クライアントシークレット不要）

• トークンの永続化 — トークンをローカルに保存し、自動更新

Related MCP server: Spotify MCP Server

セットアップ

1. Spotify アプリを作成

1. Spotify Developer Dashboard にアクセス

2. アプリを作成 をクリック

3. リダイレクトURI を http://localhost:8888/callback に設定

4. クライアント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 にローカル保存され、自動更新されます。

環境変数

ツール

認証

検索

プレイリスト

再生

ワークフロー例

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 アカウント（無料または 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