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、名前、ステータスメッセージ)を返します。
セットアップ方法
- 前提条件 – Node v26 以上、Spotify Premium アカウント、Spotify 開発者アプリ。
- インストール – リポジトリをクローンし、
npm ciを実行してからnpm run buildを実行します。 - Spotify アプリの作成 – クライアント ID/シークレットを取得し、リダイレクト URI を設定します。
- 設定 –
spotify-config.example.jsonをspotify-config.jsonにコピーし、資格情報を入力します。 - 認証 –
npm run authを実行して OAuth フローを完了します。トークンは設定ファイルに保存され、自動的に更新されます。 - サーバーの起動 –
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 に関するメモ、統合ガイドなど)。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト