Spotify MCP Server (Express.js)

Spotify MCP サーバー（Express.js）

これは、AI アシスタントが Spotify の API と連携できるようにする Model Context Protocol（MCP）サーバーの実装です。このサーバーは、トラックの検索、アーティスト情報の取得、プレイリストの管理を行うエンドポイントを提供します。

セットアップ

1. Spotify Developer アカウントを作成し、Spotify Developer Dashboard で新しいアプリケーションを作成します。
2. Spotify アプリケーションから Client ID と Client Secret を取得します。
3. ルートディレクトリに以下の内容を含む .env ファイルを作成します。

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

4. 依存関係をインストールします。

npm install

5. サーバーを起動します。

npm start

利用可能なエンドポイント

このサーバーは、以下の MCP エンドポイントを実装しています。

• POST /mcp/search - トラック、アーティスト、またはアルバムを検索します。
• GET /mcp/artist/{artistId} - アーティストの詳細情報を取得します。
• GET /mcp/track/{trackId} - トラックの詳細情報を取得します。
• GET /mcp/playlist/{playlistId} - プレイリストの情報を取得します。
• GET /mcp/me/top-tracks - ユーザーのトップトラックを取得します（認証が必要です）。
• GET /mcp/me/playlists - ユーザーのプレイリストを取得します（認証が必要です）。
• GET /mcp/me/tracks - ユーザーが保存したトラックを取得します（認証が必要です）。
• GET /mcp/auth/login - ユーザー認証用の Spotify ログイン URL を生成します。
• GET /callback - Spotify OAuth コールバックを処理し、認証コードをアクセストークンと交換します。
• POST /mcp/auth/refresh - ユーザーのアクセストークンを更新します。

使用例

AI アシスタントがこのサーバーと連携する方法の例を以下に示します。

// Search for a track
const searchResponse = await fetch('http://localhost:3000/mcp/search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'Bohemian Rhapsody',
    type: 'track'
  })
});
const searchData = await searchResponse.json();

// Get artist information
const artistResponse = await fetch('http://localhost:3000/mcp/artist/1dfeR4HaWDbWqJHLk5g1d1');
const artistData = await artistResponse.json();

MCP プロトコルの実装

このサーバーは Model Context Protocol を実装しており、AI アシスタントは次の操作を行えます。

1. Spotify で認証します。
2. 音楽コンテンツを検索します。
3. アーティスト、トラック、プレイリストの詳細情報を取得します。
4. 適切な認証を使用して、パーソナライズされたユーザーデータにアクセスします。

セキュリティに関する注意

.env ファイルを安全に保管し、バージョン管理に決してコミットしないでください。このサーバーは、機密性の高い認証情報を管理するために環境変数を使用します。