Spotify MCP Server 4ox

🚀 Spotify MCP サーバー

Spotify MCP（メディアコントロールプロトコル）サーバーは、Spotify の再生を管理および制御するためのツールです。Web インターフェイス、コマンドラインインターフェイス、音声制御など、さまざまなインターフェイスを提供し、ユーザーが音楽再生をより便利に管理できるようにします。

✨ 主な機能

• Web インターフェイス：ブラウザからサーバーにアクセスし、音楽再生を制御します。
• コマンドラインインターフェイス：ターミナルでコマンドを使用して Spotify の再生を操作します。
• AI アシスタント統合：AI アシスタント（Claude など）との統合をサポートし、音声制御を実現します。
• 音声制御：マイクから指令を入力し、音楽再生を制御します。
• API インターフェイス：RESTful API を提供し、開発者が機能を拡張しやすくします。

📦 インストール

前提条件

• Node.js と npm をインストールする
• Spotify 開発者アカウントを登録し、Client ID と Secret を取得する

セットアップ手順

1. 依存関係のインストール

npm install

2. 設定ファイルの作成 プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

PORT=8000
BRIDGE_PORT=9000
VOICE_PORT=8001
CLIENT_ID=your_spotify_client_id
CLIENT_SECRET=your_spotify_client_secret

3. サーバーの起動

npm start

💻 使用例

基本的な使用法

Web インターフェイス

ブラウザを開き、http://localhost:8000 にアクセスし、指示に従って Spotify の認証を完了します。

コマンドラインインターフェイス

ターミナルで以下のコマンドを入力します。

• 音楽を再生する：

npm run play

• 再生を一時停止する：

npm run pause

• 次の曲に切り替える：

npm run next

高度な使用法

API エンドポイント

以下は主な API エンドポイントです。

• 現在の再生情報を取得する：

GET /api/currently-playing

• 音楽を再生する：

POST /api/play

• 再生を一時停止する：

POST /api/pause

curl を使用したリクエストの送信

現在の再生情報を取得する：

curl http://localhost:8000/api/currently-playing

音楽を再生する：

curl -X POST http://localhost:8000/api/play

再生を一時停止する：

curl -X POST http://localhost:8000/api/pause

AI アシスタント統合

音声制御インターフェイスで設定メニューに入り、好きなトリガーワード（例：「小爱同学」）を入力して保存します。

音声制御

1. ターミナルで音声サーバーを起動します。

node speech/voice-server.js

2. ブラウザを開き、http://localhost:8001 にアクセスし、音声制御インターフェイスに入ります。
3. マイクボタンをクリックし、録音を開始して指令を入力します（例：「小爱同学，播放音乐」）。

すべてのサービスを実行する

start-all.js という名前のファイルを作成します。

const { spawn } = require('child_process');

const mcp = spawn('npm', ['start'], { stdio: 'inherit' });
setTimeout(() => {
  const bridge = spawn('node', ['bridge/claude-spotify-bridge.js'], { stdio: 'inherit' });
  const voice = spawn('node', ['speech/voice-server.js'], { stdio: 'inherit' });
}, 1000);

実行します。

node start-all.js

🔧 トラブルシューティング

ポートが使用中のエラー

• 他のプログラムが対象のポートを使用していないか確認します。
• .env ファイルのポート番号を変更します。

認証失敗の問題

• Client ID と Secret が正しいことを確認します。
• Spotify アカウントに再ログインします。

開発

npm run dev

📄 ライセンス

このプロジェクトは MIT ライセンスに従い、コードは自由に使用および変更できます。