Spotify MCP

spotify-mcp MCP サーバー

Claude を Spotify に接続する MCP プロジェクトです。spotipy-dev の APIをベースに構築されています。

［2026年3月のお知らせ］：このプロジェクトは現在活動していません。ほとんどの PR はマージされません。

機能

• 再生の開始、一時停止、スキップ
• トラック／アルバム／アーティスト／プレイリストの検索
• トラック／アルバム／アーティスト／プレイリストの情報取得
• Spotify のキューの管理
• プレイリストの管理、作成、更新

デモ

動画 -- 音声をオンにしてください

https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894

設定

Spotify API キーの取得

developer.spotify.comでアカウントを作成します。ダッシュボードに移動します。 redirect_uri を http://127.0.0.1:8080/callback に設定してアプリを作成します。 ポートは任意に選択できますが、http と明示的なループバックアドレス（IPv4 または IPv6）を使用する必要があります。

詳しい情報やトラブルシューティングについてはこちらをご覧ください。 動作するまでに、MCP 環境（例：Claude Desktop）を 1、2 回再起動する必要がある場合があります。

MCP 設定ファイルの場所

Cursor、Claude Desktop、その他の MCP 対応クライアントを使用する場合は、設定ファイルの場所を確認する必要があります。

• MacOS での Claude Desktop の場所：~/Library/Application\ Support/Claude/claude_desktop_config.json

• Windows での Claude Desktop の場所：%APPDATA%/Claude/claude_desktop_config.json

uvx でこのプロジェクトを実行する

このスニペットを MCP 設定ファイルに追加します。

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "git+https://github.com/varunneal/spotify-mcp",
        "spotify-mcp"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
      }
    }
  }
}

このプロジェクトをローカルで実行する

UVX を使用すると、ツールを呼び出すたびに Spotify のリダイレクト URI が開きます。これを避けるには、このリポジトリをクローンしてプロジェクトをローカルで実行できます。

git clone https://github.com/varunneal/spotify-mcp.git

次のように MCP 設定ファイルに追加します。

"spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify-mcp",
      "run",
      "spotify-mcp"
    ],
    "env": {
      "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
      "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
      "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
    }
  }

トラブルシューティング

この MCP が動作しない場合は、Issue を作成してください。次の点を確認してください。

1. uv が最新であることを確認してください。>=0.54 を推奨します。
2. ローカルにクローンした場合は、プロジェクトに実行権限を付与してください：chmod -R 755。
3. Spotify Premium に加入していることを確認してください（開発者 API の実行に必要です）。

この MCP は、MCP 仕様で定められているとおり、ログを標準エラー出力に出力します。Mac では、Claude Desktop アプリのログは ~/Library/Logs/Claude に出力されます。 その他のプラットフォームでは、こちらでログを確認できます。

次のコマンドを使って、npm から MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify-mcp run spotify-mcp

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスすると、デバッグを開始できます。

TODO

残念ながら、クールな機能の多くが廃止されました。 今後の機能追加は、比較的小規模なものか、プロジェクトの健全性を保つためのものが中心になります。

• テスト。
• プレイリストを管理する API サポートの追加。
• ページ分割された検索結果／プレイリスト／アルバムに対応する API サポートの追加。

PR を歓迎します！貢献してくださった @jamiew、@davidpadbury、@manncodes、@hyuma7、@aanurraj、@JJGO をはじめ、皆さんに感謝します。