Marcelmarais Spotify MCP Server

🚀 Spotify MCP サーバー

Spotify MCP（Music Control Protocol）サーバーは、Spotify の再生を制御および管理するためのツールです。以下の機能をサポートしています。

• 再生制御：再生、一時停止、前の曲または次の曲へのスキップ
• 再生リストの作成と管理：新しい再生リストを作成し、曲を追加または削除
• 認証と承認：OAuth 2.0 を通じて Spotify アプリを承認

🚀 クイックスタート

Spotify MCP サーバーを使用することで、Spotify の再生を便利に制御できます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 再生制御：再生、一時停止、前の曲または次の曲へのスキップ
• 再生リストの作成と管理：新しい再生リストを作成し、曲を追加または削除
• 認証と承認：OAuth 2.0 を通じて Spotify アプリを承認

📦 インストール

前提条件

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

📚 ドキュメント

開発者アプリの作成

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

設定ファイル

spotify-config.json ファイルを作成し、以下の内容を記入します。

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:8888/callback"
}

認証フロー

1. 認証スクリプトを実行します。

   npm run auth
   

2. スクリプトが認証 URL を生成します。ブラウザでこのリンクを開きます。
3. Spotify アカウントでログインし、アプリを承認します。
4. 承認が完了すると、Spotify は指定された URI にリダイレクトされ、コードパラメータが付与されます。
5. スクリプトが自動的にコードをアクセストークンとリフレッシュトークンに交換します。
6. トークンは spotify-config.json ファイルに保存されます。

統合設定

Claude Desktop の設定

Claude の設定ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["spotify-mcp-server/build/index.js"]
    }
  }
}

Cursor プラグインの設定

Cursor の MCP 設定画面で、サーバーコマンドを追加します。

node path/to/spotify-mcp-server/build/index.js

以上の手順を完了することで、Spotify MCP サーバーのセットアップと統合が完了します。