Spotify Playlist Curator MCP Server

🚀 Spotify 播放リストキュレーター MCP サーバー

このMCPサーバーは、あなたが持っている楽曲を分析し、Claude AIを利用して、雰囲気、エネルギー、BPMなどの音楽属性に基づいた曲の推薦を行い、Spotifyの再生リストを作成するのを支援します。

✨ 主な機能

• Spotifyアカウントに接続し、再生リストにアクセスする
• 再生リスト内の楽曲の音声特性を分析する
• 再生リストの雰囲気、エネルギー、リズムなどの特性をまとめる
• 再生リストの分析結果に基づいて、Claude AIから曲の推薦を取得する
• Spotify上で楽曲を検索する
• 推薦された楽曲を再生リストに追加する
• 新しい再生リストを作成する

📦 インストール

前提条件

• Node.js（v14以上）
• 登録済みのSpotify開発者アカウントとアプリケーション
• MCP経由でClaudeにアクセスできること（機械対話プロトコル）

インストール手順

1. このリポジトリをクローンします：

   git clone https://github.com/lechiffre1/Spotify-Playlist-Curator-MCP-Server.git
   cd Spotify-Playlist-Curator-MCP-Server
   

2. 依存関係をインストールします：

   npm install
   

3. 提供されている .env.example をもとに .env ファイルを作成します：

   cp .env.example .env
   

4. Spotify開発者の認証情報を設定します：

   • Spotify開発者コンソールにアクセスします。
   • 新しいアプリケーションを作成します。
   • http://localhost:3000/callback をリダイレクトURIとして追加します。
   • クライアントIDとクライアントシークレットを .env ファイルにコピーします。

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

   npm start
   

💻 使用例

基本的な使用法

認証

サーバーを起動した後、Spotifyの認証を行う必要があります：

1. ブラウザで http://localhost:3000/login にアクセスします。
2. Spotifyアカウントでログインし、アプリケーションにアクセスを許可します。
3. 認証が成功したら、ブラウザウィンドウを閉じ、MCPクライアントに戻ります。

MCPメソッド

以下のMCPメソッドが利用可能です：

getPlaylists

Spotifyの再生リストの一覧を返します。

const response = await client.getPlaylists();

getPlaylistDetails

再生リストIDに基づいて詳細情報を返します。

const response = await client.getPlaylistDetails('playlist_id');

searchSongs

Spotify上で楽曲またはアーティストを検索します。

const response = await client.searchSongs('artist name');

addSongstoPlaylists

推薦された楽曲を再生リストに追加します。

const response = await client.addSongstoPlaylists('playlist_id', ['song_ids']);

高度な使用法

以下は、このサーバーを使用した基本的な操作の例です：

const { Client } = require('./client');

async function main() {
    const client = new Client();
    
    // すべての再生リストを取得
    const playlists = await client.getPlaylists();
    console.log('再生リスト:', playlists);

    // 特定の再生リストの詳細情報を取得
    const playlistDetails = await client.getPlaylistDetails(playlists[0].id);
    console.log('再生リスト詳細情報:', playlistDetails);

    // 楽曲を検索
    const searchResults = await client.searchSongs('Taylor Swift');
    console.log('検索結果:', searchResults);

    // 楽曲を再生リストに追加
    await client.addSongstoPlaylists(playlistDetails.id, ['song_id_1', 'song_id_2']);
    console.log('楽曲が再生リストに追加されました');
}

main().catch(console.error);

📄 ライセンス

Spotify 播放リストキュレーター MCP サーバーの使用は、MITライセンスの対象となります。
Copyright (c) 年份, 作者姓名。