spotify-mcp MCP サーバー

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

特徴

再生を開始、一時停止、スキップする
トラック/アルバム/アーティスト/プレイリストを検索
トラック/アルバム/アーティスト/プレイリストに関する情報を取得する
Spotifyキューを管理する

デモ

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

構成

Spotify APIキーの取得

developer.spotify.comでアカウントを作成します。ダッシュボードに移動します。redirect_uri をhttp://localhost:8888にしてアプリを作成します。（任意のポートを選択できますが、http と localhost を使用する必要があります）。「使用する API」を「Web Playback SDK」に設定しました。

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

このプロジェクトはまだ一時的な環境（ uvx使用など）向けに設定されていません。このリポジトリをクローンしてローカルで実行してください。

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

このツールを MCP サーバーとして追加します。

MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

"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://localhost:8888"
    }
  }

トラブルシューティング

このMCPが動作しない場合は、問題を報告してください。以下にヒントをいくつか示します。

uvが更新されていることを確認してください。バージョン>=0.54推奨します。
claude にプロジェクトの実行権限があることを確認します: chmod -R 755 。
Spotify Premium があることを確認します (開発者 API を実行するために必要)。

やるべきこと

残念ながら、Spotify API から多くの便利な機能が廃止されました。新しい機能のほとんどは、比較的マイナーなもの、またはプロジェクトの健全性に関するものです。

テスト。
プレイリストを管理するための API サポートを追加します。
ページ分割された検索結果/プレイリスト/アルバムの API サポートを追加します。

展開

（やること）

Smithery経由でインストール

Smithery経由で Claude Desktop 用の spotify-mcp を自動的にインストールするには:

npx -y @smithery/cli install @varunneal/spotify-mcp --client claude

建築と出版

配布用のパッケージを準備するには:

依存関係を同期し、ロックファイルを更新します。

uv sync

パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

PyPI に公開:

uv publish

注: 環境変数またはコマンドフラグを使用して PyPI 資格情報を設定する必要があります。

トークン: --tokenまたはUV_PUBLISH_TOKEN
またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/varun/Documents/Python/spotify_mcp run spotify-mcp

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

Spotify MCP Server

Integrations