Spotify MCP サーバー

このプロジェクトは、 CursorやClaude for Desktop (macOS および Windows のみ) などの MCP クライアントを通じて自然言語を使用して Spotify の再生を制御できるModel Context Protocol (MCP)サーバーを実装します。

特徴

このサーバーは次のツールを公開します。

• play : トラック、アルバム、またはプレイリストを再生するか、再生を再開します。
• pause : 再生を一時停止します。
• next : 次のトラックにスキップします。
• previous : 前のトラックにスキップします。
• get_current_track : 現在再生中のトラックに関する情報を取得します。
• search : トラック、アルバム、アーティスト、またはプレイリストを検索します。

前提条件

• Bun （バージョン1.0.0以降）
• Spotify Premium アカウント。
• Spotify 開発者アプリケーション:
  • Spotify 開発者ダッシュボードで作成します。
  • クライアント ID とクライアント シークレットを取得します。
  • アプリの設定のリダイレクト URI にhttp://localhost:8888/callbackを追加します。
• MCP クライアント (例: Cursor または Claude for Desktop)。

インストールとセットアップ

1. リポジトリをクローンします。
   git clone https://github.com/obre10off/spotify-mcp.git cd spotify-mcp
2. 依存関係をインストールします:
   bun install
3. .envファイルを作成します。プロジェクトディレクトリのルートに.envというファイルを作成します。以下のコードを追加し、プレースホルダーを実際のSpotifyの認証情報に置き換えます。
   SPOTIFY_CLIENT_ID=your_spotify_client_id SPOTIFY_CLIENT_SECRET=your_spotify_client_secret SPOTIFY_REDIRECT_URI=http://localhost:8888/callback # These will be filled in after running the auth script: SPOTIFY_ACCESS_TOKEN= SPOTIFY_REFRESH_TOKEN=
4. 認証スクリプトを実行します。このスクリプトはブラウザを開き、Spotify にログインして権限を付与するように要求し、最初のアクセス トークンと更新トークンを取得します。
   bun run auth
   スクリプトはコンソールにSPOTIFY_ACCESS_TOKENとSPOTIFY_REFRESH_TOKENを出力します。これらの値を.envファイルにコピーしてください。
5. MCP クライアントを構成します。
   • カーソル：
     • カーソルの設定を開きます (Cmd+, または Ctrl+,)。
     • 「モデルコンテキストプロトコル」を検索します。
     • 「settings.json で編集」をクリックします。
     • mcp.servers配列に以下を追加します ( /absolute/path/to/your/spotify-mcp``spotify-mcpディレクトリへの絶対パスに置き換えます)。
       { "mcp.servers": [ { "spotify": { "command": "bun", "args": ["/absolute/path/to/your/spotify-mcp/src/index.ts"], "env": { "SPOTIFY_CLIENT_ID": "your_spotify_client_id", "SPOTIFY_CLIENT_SECRET": "your_spotify_client_secret", "SPOTIFY_REDIRECT_URI": "http://localhost:8888/callback", "SPOTIFY_ACCESS_TOKEN": "your_spotify_access_token", "SPOTIFY_REFRESH_TOKEN": "your_spotify_refresh_token" } } } ] }
       値をsettings.jsonファイルに追加するのではなく、 .envファイルを使用して、Spotifyに関連する環境変数のみをそこに置くことをお勧めします。
   • デスクトップ版Claude（macOS/Windows）:
     • Claude for Desktop 構成ファイルを開きます。
       • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
       • Windows: %APPDATA%\Claude\claude_desktop_config.json
     • mcpServersオブジェクトに以下を追加します ( /absolute/path/to/your/spotify-mcp``spotify-mcpディレクトリへの絶対パスに置き換えます): GXP6
   • **重要:**クライアント構成では常に絶対パスを使用してください。
6. MCPクライアントを再起動します設定を適用するには、必ず MCP クライアント (Cursor/Claude) を再起動してください。

サーバーの実行