Spotify MCP サーバー
Claude を介して Spotify とやり取りできるシンプルな Model Context Protocol (MCP) サーバーです。このサーバーにより、Claude は Spotify アカウントを使って曲を検索したり、プレイリストを作成したり、おすすめの表示などを行うことができます。
特徴
- Spotifyでトラックを検索する
- Spotifyプロフィールを表示する
- プレイリストを作成する
- プレイリストにトラックを追加する
- パーソナライズされた音楽のおすすめを受け取る
利用可能なツール
| ツール名 | 説明 |
|---|
set-spotify-credentials | Spotifyの認証情報を設定する |
check-credentials-status | 資格情報が有効かどうか、誰がログインしているかを確認します |
search-tracks | 名前、アーティスト、キーワードでトラックを検索 |
get-current-user | Spotifyプロフィール情報を取得する |
create-playlist | アカウントに新しいプレイリストを作成する |
add-tracks-to-playlist | 既存のプレイリストにトラックを追加する |
get-recommendations | シードトラックに基づいて推奨事項を取得する |
セットアップ手順
1. 前提条件
- Node.js v16以上
- npm
- Spotifyアカウント
- 登録済みのSpotify開発者アプリケーション
2. Spotify開発者アプリを作成する
- Spotify開発者ダッシュボードへ
- Spotifyアカウントでログイン
- 「アプリを作成」をクリックします
- アプリ名と説明を入力してください
- リダイレクトURIとして
http://localhost:8888/callbackを追加します。 - クライアントIDとクライアントシークレットをメモしてください
3. プロジェクトをインストールする
# Clone or download the project first
cd spotify-mcp-server
# Install dependencies
npm install
4. Spotifyトークンを入手する
spotify-auth.jsファイルを編集して、クライアント ID とクライアント シークレットを追加します。
// Replace these with your Spotify app credentials
const CLIENT_ID = "your_client_id_here";
const CLIENT_SECRET = "your_client_secret_here";
次に、認証スクリプトを実行します。
これにより、次のようになります。
- ブラウザでURLを開く
- Spotifyにログインするように促す
- アカウントにアクセスする許可を求める
- トークンを
secrets.jsonに保存する
5. MCPサーバーを構築する
6. Claudeデスクトップを設定する
Claude Desktop 構成ファイルを編集します。
- macOSの場合:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows の場合:
%APPDATA%\Claude\claude_desktop_config.json
次の構成を追加します。
{
"mcpServers": {
"spotify": {
"command": "node",
"args": ["/full/path/to/spotify-mcp-server/build/spotify-mcp-server.js"]
}
}
}
/full/path/to/spotify-mcp-serverプロジェクト ディレクトリへの実際のパスに置き換えます。
7. Claude Desktopを再起動します
新しい構成をロードするには、Claude Desktop を閉じて再度開きます。
使用法
クロードとの会話を始めるときは、まず Spotify の資格情報を設定する必要があります。
secrets.jsonファイルを参照して資格情報を取得しますset-spotify-credentialsツールを使用して認証する- その後、他のSpotifyツールを使用します
プロンプトの例
資格情報の設定
I want to connect to my Spotify account. Here are my credentials from secrets.json:
Tool: set-spotify-credentials
Parameters:
{
"clientId": "your_client_id",
"clientSecret": "your_client_secret",
"accessToken": "your_access_token",
"refreshToken": "your_refresh_token"
}
基本コマンド
アカウントを確認してください:
Can you check who I'm logged in as on Spotify?
Tool: get-current-user
Parameters: {}
トラックを検索:
Search for songs by Weekend
Tool: search-tracks
Parameters:
{
"query": "Taylor Swift",
"limit": 5
}
プレイリストを作成します:
Create a new playlist called "My Pretty pretty girlfriend"
Tool: create-playlist
Parameters:
{
"name": "My Pretty pretty girlfriend",
"description": "For my girlfriend. Created with Claude and the Spotify MCP server"
}
複数ステップのタスク
曲のプレイリストを作成する:
I want to create a workout playlist with energetic songs. First, search for some high-energy songs. Then create a playlist called "Workout Mix" and add those songs to it.
お気に入りに基づいて推奨事項を取得する:
I like the song "Blinding Lights" by The Weeknd. Can you search for it, then find similar songs, and create a playlist with those recommendations?
トラブルシューティング
- エラー: アクセストークンが利用できません: まず
set-spotify-credentialsツールを使用して資格情報を設定する必要があります - 認証失敗: トークンの有効期限が切れている可能性があります。認証スクリプトを再度実行して、新しいトークンを取得してください。
- 無効な認証情報: 正しいクライアントIDとクライアントシークレットを使用していることを確認してください
注記
- サーバーは資格情報をメモリにのみ保存します
- 新しい会話を始めるたびに認証情報を設定する必要があります
- Claude Desktopが再起動した場合は、資格情報を再度設定する必要があります。