Spotify MCPサーバー

Model Context Protocol (MCP)サーバーで、Spotify Web APIと連携するためのツールを提供します。ClaudeのようなAIアシスタントが音楽の検索、再生制御、プレイリスト管理などを行えるようになります。

機能

• 検索 - トラック、アルバム、アーティスト、プレイリスト、番組、エピソード、オーディオブックの検索

• 再生制御 - 再生、一時停止、スキップ、シーク、音量調整、シャッフル、リピート、キュー管理

• プレイリスト - 作成、更新、トラックの追加/削除/並べ替え

• ライブラリ - 保存済みトラック、アルバム、番組、エピソード、オーディオブックの表示と管理

• ブラウズ - アルバム詳細、アーティスト情報、トラックメタデータの取得

• ポッドキャスト & オーディオブック - 番組、エピソード、オーディオブック、チャプターのブラウズ

• ユーザープロフィール - プロフィール、トップアーティスト/トラック、フォロー中のアーティストの表示

• 44種類のツール - 非推奨ではないSpotify Web APIエンドポイントを網羅

前提条件

• uv — curl -LsSf https://astral.sh/uv/install.sh | sh でインストール

• Spotify Developer アカウント

• Client IDとClient Secretを持つSpotifyアプリ

Spotify認証情報の取得

1. Spotify Developer Dashboard にアクセス

2. Create App をクリック

3. アプリの詳細を入力:

   • App name: 任意の名前 (例: "My MCP Server")

   • App description: 任意

   • Redirect URI: http://127.0.0.1:8888/callback

   • Which API/SDKs are you planning to use?: Web API を選択

4. Save をクリック

5. アプリのページで Client ID を確認

6. Show client secret をクリックして Client Secret を表示

重要: リダイレクトURIは http://127.0.0.1:8888/callback (または SPOTIFY_REDIRECT_URI に設定したもの) と完全に一致している必要があります。localhost は使用せず、127.0.0.1 を使用してください。

インストール

以下のクライアントから選択してください。すべての例で uvx を使用してサーバーをオンデマンドで取得するため、クローンや手動インストールは不要です。

Claude Code

claude mcp add spotify \
  -e SPOTIFY_CLIENT_ID=your_client_id \
  -e SPOTIFY_CLIENT_SECRET=your_client_secret \
  -- uvx mcp-server-spotify

その他のMCPクライアント

ほとんどのMCPクライアントはJSONファイルでサーバーを設定します。クライアントのMCP設定に以下のエントリを追加してください:

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": ["mcp-server-spotify"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

ローカルチェックアウトからの実行

開発用、または修正版を実行したい場合:

git clone https://github.com/llyfn/spotify-mcp.git
cd spotify-mcp && uv sync

その後、uvx の代わりにローカルのチェックアウト先をクライアントに指定します:

"command": "uv",
"args": ["--directory", "/absolute/path/to/spotify-mcp", "run", "mcp-server-spotify"]

設定

認証

このサーバーはSpotifyの Authorization Code フローを使用します:

1. 初回使用時、サーバーがブラウザでSpotifyのログインページを開きます

2. Spotifyがアクセス許可を求めます — サーバーはツールセット全体（再生、ライブラリ、プレイリスト、ユーザーデータ）に必要なすべてのスコープを要求します

3. 承認後、Spotifyはローカルのコールバックサーバーにリダイレクトします

4. サーバーは認証コードをアクセストークン/リフレッシュトークンと交換します

5. トークンは ~/.spotify-mcp/credentials.json に安全に保存されます

6. トークンは期限切れになると自動的に更新されます

ヘッドレス環境（SSH、Docker）で実行する場合、認証URLがstderrに出力されます。それをコピーして手動でブラウザに貼り付けてください。

再認証

再認証が必要な場合（アクセスを取り消した後など）、保存された認証情報を削除してください:

rm ~/.spotify-mcp/credentials.json

利用可能なツール

検索

アルバム

アーティスト

トラック

プレイリスト

ライブラリ

プレイヤー

番組 & ポッドキャスト

オーディオブック

ユーザー

アーティスト/ユーザーのフォローには、同じ save_to_library / remove_from_library / check_saved_in_library ツールを使用します — アーティストまたはユーザーのURIを渡してください。

コントリビューション

開発環境のセットアップとガイドラインについては CONTRIBUTING.md を参照してください。

ライセンス

MIT - 詳細は LICENSE を参照してください。