Spotify MCP Server (express.js)

🚀 Spotify MCP サーバー（Express.js）

このサーバーは、モデルコンテキストプロトコル（MCP）を実装した Spotify サーバーで、AI アシスタントが Spotify の API とやり取りできるようにします。このサーバーは、曲の検索、アーティスト情報の取得、プレイリストの管理などの機能を提供します。

🚀 クイックスタート

📦 インストール

1. Spotify 開発者コンソールで開発者アカウントを作成し、Spotify 開発者ダッシュボード で新しいアプリを作成します。
2. Spotify アプリから クライアント ID と クライアントシークレット を取得します。
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

💻 使用例

基本的な使用法

以下は、AI アシスタントがサーバーとやり取りする例です。

// 曲を検索する
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();

// アーティスト情報を取得する
const artistResponse = await fetch('http://localhost:3000/mcp/artist/1dfeR4HaWDbWqJHLk5g1d1');
const artistData = await artistResponse.json();

📚 ドキュメント

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

このサーバーは、以下の 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 - ユーザーのアクセストークンを更新します。

MCP プロトコルの実装

このサーバーは、モデルコンテキストプロトコルを実装しており、AI アシスタントが以下のことを行えるようにします。

1. Spotify で認証を行う。
2. 音楽コンテンツを検索する。
3. アーティスト、曲、プレイリストの詳細情報を取得する。
4. ユーザーの個人情報にアクセスする（適切な認証が必要です）。

🔧 技術詳細

このサーバーは、Express.js を使用して構築されており、Spotify API とのやり取りを容易にします。環境変数を使用して敏感な情報を管理することで、セキュリティを確保しています。

⚠️ 重要提示

.env ファイルのセキュリティを確保し、バージョン管理にコミットしないでください。サーバーは環境変数を使用して機密情報を管理し、セキュリティを維持しています。