marcelmarais/spotify-mcp-server

Lightweight MCP server for Spotify

Spotify MCP Server – その概要

Spotify MCP Server は、Spotify 向けに Model Context Protocol (MCP) を実装した小規模な Node.js サービスです。これにより、AI アシスタント(Claude、Cursor、VS Code の Cline 拡張機能など)があなたの Spotify アカウントとやり取りできるようになります。再生中の曲の照会、カタログの検索、プレイリストの読み取りや編集、再生の制御、音量の調整などが、MCP を通じて公開される標準化された「ツール」群を通じてすべて可能になります。


主な機能(README に記載の内容)

カテゴリ 操作(例) 説明
読み取り searchSpotify、getNowPlaying、getMyPlaylists、getPlaylistTracks、getQueue、getAvailableDevices Spotify のカタログを検索し、現在のトラックを取得し、プレイリストを一覧表示し、再生キューを確認し、接続済みデバイスを検出します。
再生制御 playMusic、pausePlayback、resumePlayback、skipToNext、skipToPrevious、addToQueue、setVolume、adjustVolume 音楽の開始/停止、キューの移動、アイテムの追加、音量の変更(Premium が必要)を行います。
アルバム処理 getAlbums、getAlbumTracks、saveOrRemoveAlbumForUser、checkUsersSavedAlbums アルバムのメタデータを取得し、トラックを一覧表示し、ライブラリへのアルバムの保存/削除を行います。
プレイリスト処理 createPlaylist、addTracksToPlaylist、removeTracksFromPlaylist、updatePlaylist、reorderPlaylistItems 新しいプレイリストの作成、トラックの追加/削除、メタデータの編集、アイテムの並べ替えを行います。
ユーザーライブラリ getUsersSavedTracks、removeUsersSavedTracks、getFollowedArtists 「いいね!」した曲やフォロー中のアーティストを読み取ったり変更したりします。

すべてのツールは、AI が直接利用できる構造化 JSON(ID、名前、ステータスメッセージ)を返します。


セットアップ方法

  1. 前提条件 – Node v26 以上、Spotify Premium アカウント、Spotify 開発者アプリ。
  2. インストール – リポジトリをクローンし、npm ci を実行してから npm run build を実行します。
  3. Spotify アプリの作成 – クライアント ID/シークレットを取得し、リダイレクト URI を設定します。
  4. 設定 – spotify-config.example.json を spotify-config.json にコピーし、資格情報を入力します。
  5. 認証 – npm run auth を実行して OAuth フローを完了します。トークンは設定ファイルに保存され、自動的に更新されます。
  6. サーバーの起動 – node build/index.js(デフォルトは stdio トランスポート)、または HTTP ベースのクライアントの場合は MCP_TRANSPORT=http を設定し、必要に応じて OAuth で保護されたエンドポイント用に MCP_AUTH=spotify を設定します。

AI ツールでの使用

  • Claude Desktop – ビルド済みの index.js を指す MCP エントリを追加します。
  • Cursor – 設定の MCP タブに同じコマンドを追加します。
  • VS Code Cline 拡張機能 – サーバーコマンドと自動承認されたツールを一覧表示する cline_mcp_settings.json を提供します。

サーバーは長時間実行される HTTP プロセス(デフォルトでポート 3000)として実行できるため、複数のクライアントで共有できます。MCP_AUTH=spotify が設定されている場合、エンドポイントは RFC 9728 に従い、OAuth 対応クライアントが Spotify トークンを自分で取得できるようにし、個人のリフレッシュトークンをサーバーに保存しないようにします。


誰にとって役立つか?

  • AI エージェントを開発する開発者 – より広範なワークフローの一部として音楽再生を制御する必要がある場合(例:「コーディング中に背景音楽を再生して」)。
  • パワーユーザー – LLM ベースのアシスタント(Claude、Cursor)に、手動でクリックすることなくプレイリストを管理させたり、現在の曲を取得させたいユーザー。
  • 実験者 – MCP を、サードパーティのサービスを LLM に公開する方法として探求しているユーザー。

結論

Spotify MCP Server は、Model Context Protocol と Spotify Web API の間の本格的でオープンソースのブリッジであり、AI アシスタントが Spotify アカウントをプログラムで読み取り・操作するための豊富なツールボックスを提供します。完全にドキュメント化され、OAuth 処理を含み、ローカルまたは複数クライアント用の HTTP プロキシの背後で実行できます。


リポジトリ: marcelmarais/spotify-mcp-server ライセンス / ステータス: README には明記されていませんが、プロジェクトは積極的にメンテナンスされているようです(ビルドスクリプト、Docker に関するメモ、統合ガイドなど)。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト