Spotify Data

Spotify Data MCP Server

AI アシスタント（Claude Desktop、 Claude Code、Cursor、VS Code などの MCP クライアント）が Spotify のデータを検索できるMCPサーバーです。トラックの再生回数、アーティストの月間リスナー数、世界ランキングと上位都市、国別の Top 200 とバイラルチャート、トラックごとの再生回数付きのアルバムやプレイリスト、検索、ISRC 検索、ジャンル、ムード、BPMに対応しています。

お使いのマシン上で動作し、CheckLeaked Spotify Data APIをご自身の API キーで呼び出します。 無料トライアルキーの利用にカードは必要ありません。手順ガイド： spotify.checkleaked.cc/spotify-mcp-server。

uvx checkleaked-spotify-mcp
# or, with Docker
docker run -i --rm -e SPOTIFY_API_KEY=your-api-key ghcr.io/eduair94/spotify-data-mcp

非公式です。Spotify との提携、承認、スポンサー関係はありません。 Spotify は Spotify AB の商標です。

たとえば、こんなことを尋ねられます

• 「Bad Bunny と Karol G の月間リスナー数は？」
• 「このアルバムの全トラックの再生回数を教えてください： https://open.spotify.com/album/3RQQmkQEvNCY4prGKE6oc5」
• 「今日のブラジルの Top 200 を表示してください。上位 20 曲だけで。」
• 「Taylor Swift を最もよく聴いている都市はどこですか？」
• 「Blinding Lights と Bohemian Rhapsody の再生回数を比較してください。」
• 「Today's Top Hits の最初の 30 トラックを、再生回数とともに再生回数順で一覧表示してください。」
• 「The Weeknd の楽曲のジャンル、ムード、BPM を教えてください。」
• 「ISRC が USUG11904206 の Spotify トラックはどれですか？」
• 「Rosalía の関連アーティストと、それぞれの月間リスナー数を教えてください。」

1. API キーを取得する

すべてのユーザーが自分専用のキーを用意する必要があります。次のいずれかを選んでください。

オプション	費用	取得先	SPOTIFY_API_PROVIDER
無料トライアル：7 日間で 500 リクエスト、カード不要	無料	spotify.checkleaked.cc/pricing#trial	direct（自動検出）
spotify81 の RapidAPI リスティング	無料の Basic プラン、有料プランあり	rapidapi.com/airaudoeduardo/api/spotify81	rapidapi（デフォルト）
直接利用の有料キー	料金ページを参照	spotify.checkleaked.cc/pricing	direct（自動検出）

spotify.checkleaked.cc が発行したキー（sapi_ で始まるもの）は自動的に Direct API に送信され、それ以外のキーは RapidAPI キーとして扱われます。これを上書きする場合に限り、SPOTIFY_API_PROVIDER を設定してください。

2. MCP クライアントに追加する

このサーバーは PyPI で公開されており、uvx（uv の一部）で動作します。pip install uv でインストールするか、uv のインストールガイドを参照してください。初回の実行時に、uvx がパッケージをキャッシュされた隔離環境にダウンロードします。以下のスニペットでは、your-api-key をご自身のキーに置き換えてください。

インストール不要：ホスト型サーバー（Claude.ai、ChatGPT、その他のリモート MCP クライアント）

同じ 12 個のツールに、ChatGPT 用の fetch ツールを加えたものが、https://spotify-proxy.checkleaked.cc/mcp（Streamable HTTP）でもホストされています。上記のキーをどれでも使用できます。spotify.checkleaked.cc のキー（sapi_ で始まるもの）は直接 API で使用され、それ以外のキーは RapidAPI の spotify81 の掲載サービスで使用されるため、RapidAPI のサブスクリプションも利用できます。URL に &provider=direct または &provider=rapidapi を追加すると、プロバイダーを選択できます。

• Claude.ai（設定 → コネクタ → カスタムコネクタを追加）と ChatGPT（設定 → コネクタ。検索ツールとフェッチツールを呼び出すディープリサーチでも利用できます）はカスタムヘッダーを送信できないため、キーを URL に含めてください： https://spotify-proxy.checkleaked.cc/mcp?key=your-api-key。この URL はパスワードと同様に扱ってください。

• ヘッダーを送信できるクライアントでは、https://spotify-proxy.checkleaked.cc/mcp を使用し、 Authorization: Bearer your-api-key を指定してください。Claude Code の場合：

  claude mcp add --transport http spotify-data https://spotify-proxy.checkleaked.cc/mcp --header "Authorization: Bearer your-api-key"
  

各ツール呼び出しで、直接 API を呼び出す場合と同様に、キーのリクエストを 1 件消費します。

Claude Desktop

claude_desktop_config.json を編集し（設定 > 開発者 > 設定を編集。macOS： ~/Library/Application Support/Claude/claude_desktop_config.json、Windows： %APPDATA%\Claude\claude_desktop_config.json）、Claude Desktop を再起動してください：

{
  "mcpServers": {
    "spotify-data": {
      "command": "uvx",
      "args": ["checkleaked-spotify-mcp"],
      "env": {
        "SPOTIFY_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop が uvx を見つけられない場合は、command にフルパスを指定してください（macOS／Linux では which uvx、Windows では where uvx を実行します）。

Claude Code

claude mcp add spotify-data -s user -e SPOTIFY_API_KEY=your-api-key -- uvx checkleaked-spotify-mcp

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加してください：

{
  "mcpServers": {
    "spotify-data": {
      "command": "uvx",
      "args": ["checkleaked-spotify-mcp"],
      "env": {
        "SPOTIFY_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code（GitHub Copilot エージェントモード）

.vscode/mcp.json に追加してください。VS Code はキーの入力を一度だけ求め、安全に保存します：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "spotify-api-key",
      "description": "Spotify Data API key",
      "password": true
    }
  ],
  "servers": {
    "spotify-data": {
      "type": "stdio",
      "command": "uvx",
      "args": ["checkleaked-spotify-mcp"],
      "env": {
        "SPOTIFY_API_KEY": "${input:spotify-api-key}"
      }
    }
  }
}

その他の MCP クライアント

環境変数 SPOTIFY_API_KEY を設定して、uvx checkleaked-spotify-mcp（stdio トランスポート）を実行してください。 uvx を使用しない場合は、pip install checkleaked-spotify-mcp を実行してから、 checkleaked-spotify-mcp（または python -m checkleaked_spotify_mcp）を実行してください。

Docker

同じサーバーがコンテナーイメージ（linux/amd64 および linux/arm64）として公開されています：

docker run -i --rm -e SPOTIFY_API_KEY=your-api-key ghcr.io/eduair94/spotify-data-mcp

クライアント設定では、"command": "docker" と "args": ["run", "-i", "--rm", "-e", "SPOTIFY_API_KEY", "ghcr.io/eduair94/spotify-data-mcp"] を使用し、env に SPOTIFY_API_KEY を設定してください。-i はそのままにしてください。サーバーは stdin と stdout を介して MCP 通信を行います。

設定

変数	必須	説明
SPOTIFY_API_KEY	はい	API キー（上記を参照）。
SPOTIFY_API_PROVIDER	いいえ	rapidapi（RapidAPI の spotify81.p.rapidapi.com）または direct（https://spotify-proxy.checkleaked.cc/spotify-data）。デフォルトではキーから判定されます。
SPOTIFY_API_BASE	いいえ	選択したプロバイダーのベース URL を上書きします。

キーがなくてもサーバーは起動し、各ツールは無料キーの取得先を示すエラーを返します。そのため、チャット内から問題の内容を確認できます。

ツール

すべてのツールは読み取り専用です。すべての id パラメーターには、単体の ID、spotify: URI、またはopen.spotify.com URL（/intl-xx/と?si=の有無は問いません）を指定できます。

ツール	返される内容	バッチ	リクエスト数
search	クエリに一致するトラック、アーティスト、アルバム、またはプレイリスト。ID と URL を含みます（トラックの再生回数は任意）	最大 20 件	1
get_tracks	トラックの詳細：アーティスト、アルバム、リリース日、再生時間、ISRC、人気度、再生回数。ジャンル／ムード／BPM／クレジットは任意です	50 トラック	1
get_track_play_count	名前、アーティスト、リリース日を含む累計再生回数	50 トラック	1
get_track_insights	ジャンル、ムード、アクティビティ（重み付き）、BPM、クレジット、歌詞の有無、言語	50 トラック	1
get_artists_stats	月間リスナー数、フォロワー数、世界ランキング、人気度、ジャンル、上位 5 都市	50 アーティスト	1
get_artist_overview	統計情報、再生回数付きのトップトラック、最新リリース、ディスコグラフィーの件数、関連アーティスト、略歴、リンクを含むプロフィール	1 アーティスト	1
get_artist_insights	アーティストのトップトラックから得られるジャンル、ムード、テンポのプロフィール	20 アーティスト	1
get_related_artists	「ファンにも人気のアーティスト」	1 アーティスト	1
get_album	アルバムの詳細と、再生回数およびアルバムの合計再生回数を含む全トラック	1 アルバム	1
get_playlist	名前、オーナー、フォロワー数、説明、ページあたり最大 100 トラック（再生回数付き）	100 トラック	1 ページ目は 2、以降は 1
get_chart	国別のトップ 200、バイラル、トップアーティスト、またはトップアルバム（日次または週次、最新または日付指定）。再生回数は任意です	最大 200 件	1
isrc_lookup	ISRC に対応する Spotify トラック	1 ISRC	1

出力はコンパクトな JSON 形式で、ID、名前、数値、open.spotify.com URL が含まれます。リストには上限があり、モデルのコンテキストに収まるようになっています。注意事項：

• 再生回数が 1,000 回未満のトラックは、Spotify では再生回数が 0 と表示されます。
• 再生回数は累計再生回数です。チャートの streams は、そのチャートの日または週の再生回数です。
• 結果は API によってしばらくキャッシュされることがあります（再生回数は約 1 時間）。
• API の歌詞、音声ダウンロード、Webhook、トラッキング、AI エンドポイントは意図的に公開していません。

プライバシー

サーバーは、設定された API（RapidAPI の spotify81.p.rapidapi.com または spotify-proxy.checkleaked.cc）とのみ通信します。x-rapidapi-key ヘッダーでキーを送信し、ディスクには何も保存せず、テレメトリーもありません。リクエストには checkleaked-spotify-mcp/<version> ユーザーエージェントが含まれます。

ホスト型サーバーは、各ツール呼び出しを同じ API にキーとともに渡し、会話データを保持しません。URL に含めたキーは、他の URL と同様にリクエストログに記録される場合があるため、クライアントが対応している場合は Authorization ヘッダーを使用してください。

開発

git clone https://github.com/eduair94/spotify-data-mcp
cd spotify-data-mcp
python -m venv .venv && . .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
pytest                                          # offline tests (recorded API answers)
SPOTIFY_MCP_LIVE=1 SPOTIFY_API_KEY=... pytest -m live   # optional live smoke test

公式の MCP Python SDK と checkleaked-spotify-api SDK を基盤に構築されています。 API リファレンス：spotify-proxy.checkleaked.cc/docs。 サービスのステータス：spotify.checkleaked.cc/status。

ライセンス

MIT