Spotify MCP Server Cv6

🚀 Spotify 多用途コンソール（MCP）サーバーガイド

Spotify 多用途コンソール（MCP）サーバーは、Node.js をベースにしたツールで、コマンドラインインターフェイス（CLI）を通じて Spotify サービスとやり取りすることができます。このツールは、音楽再生制御、データ検索、システム設定など、様々な機能をサポートしています。

✨ 主な機能

コアコマンド

1. 再生制御

   • play: 音楽の再生を開始
   • pause: 再生を一時停止
   • resume: 再生を再開
   • stop: 再生を停止
   • toggle: 再生状態を切り替える（再生/一時停止）

2. メディア操作

   • next: 次の曲にスキップ
   • previous: 前の曲に戻る
   • repeat: リピート再生モードを有効にする
   • shuffle: 現在の再生リストをシャッフルする

3. 音量調整

   • volume <percentage>: 音量を調整する（範囲: 0-100）
   • mute: ミュートする
   • unmute: ミュートを解除する

4. 時間調整

   • seek <seconds>: 指定した秒数にジャンプする
   • replay: 現在の音楽を最初から再生する

高度な機能

1. 再生リスト管理

   • create-playlist "<playlist-name>": 新しい再生リストを作成する
   • add-to-playlist "<track-id>" "<playlist-name>": 指定した再生リストに曲を追加する
   • remove-from-playlist "<track-id>" "<playlist-name>": 再生リストから曲を削除する
   • delete-playlist "<playlist-name>": 指定した再生リストを削除する

2. お気に入り管理

   • save-track "<track-id>": 曲を"liked"リストに追加する
   • remove-track "<track-id>": "liked"リストから曲を削除する

3. ユーザーデータ検索

   • get-playlists: すべての再生リスト情報を取得する
   • get-tracks "<playlist-name>": 指定した再生リスト内のすべての曲を取得する
   • get-current: 現在再生中の音楽情報を表示する
   • search "<query>": 曲またはアーティストを検索する

4. システム設定

   • set-device "<device-id>": デフォルトのサウンドデバイスを切り替える
   • set-destination "<endpoint>": メディアデータの転送先を設定する

📦 インストール

前提条件

1. Node.js v16 以上がインストールされていること
2. Spotify Premium アカウントを持っていること
3. 登録済みの Spotify 開発者アプリがあること

インストール手順

git clone https://github.com/marcelmarais/spotify-mcp-server.git
cd spotify-mcp-server
npm install
npm run build

Spotify 開発者アプリの作成

1. Spotify 開発者コンソールにアクセスする
2. Spotify アカウントでログインする
3. "新しいアプリを作成" ボタンをクリックする
4. アプリ名と説明を入力する
5. サービス利用規約に同意し、"作成" をクリックする
6. 新しいアプリのダッシュボードで、クライアント ID を確認する
7. "クライアントシークレットを表示" をクリックして、クライアントシークレット を表示する
8. "設定を編集" をクリックし、リダイレクト URI を追加する（例: http://localhost:8888/callback）
9. 変更を保存する

Spotify API の設定

プロジェクトのルートディレクトリに spotify-config.json ファイルを作成します（提供されているサンプルをコピーして変更することができます）。

cp example.spotify-config.json .spotify-config.json

設定ファイルを編集します。

{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "redirectUri": "http://localhost:8888/callback"
}

💻 使用例

認証ログイン

以下のコマンドを実行し、Spotify アカウントで認証します。

npm run authorize

指示に従って OAuth フローを完了します。

基本的な操作

• 音楽を再生する: npm run play
• 再生を一時停止する: npm run pause
• 次の曲にスキップする: npm run next
• 前の曲に戻る: npm run previous

複雑なタスク

• 新しい再生リストを作成する:

  npm run create-playlist "My New Playlist"
  

• 再生リストに曲を追加する:

  npm run add-to-playlist "123456789" "My New Playlist"
  

🔧 高度な設定

環境変数の設定

以下の環境変数を使用して、ツールをさらにカスタマイズすることができます。

SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:8888/callback

これらの変数を .env ファイルに追加します。

📚 ドキュメント

開発ツールとの統合

1. Claude Desktop

   • Claude プラグインをインストールする
   • 環境変数を設定する
   • コマンドを使用して Spotify 機能を呼び出す

2. Cursor

   • Cursor プラグインをインストールする
   • カスタムショートカットを追加する
   • MCP サービスを統合する

3. VS Code

   • 対応する拡張機能をインストールする
   • 起動タスクを設定する
   • プラグインを使用して操作する

参考資料

• Node.js 公式ドキュメント
• Spotify API ドキュメント
• 開発者ガイド

以上の手順に従えば、Spotify 多用途コンソールサーバーを簡単に設定して使用し、Spotify サービスを効率的に管理し自動化することができます。