Spotify MCP サーバー

Claude を介して Spotify とやり取りできるシンプルな Model Context Protocol (MCP) サーバーです。このサーバーにより、Claude は Spotify アカウントを使って曲を検索したり、プレイリストを作成したり、おすすめの表示などを行うことができます。

特徴

Spotifyでトラックを検索する
Spotifyプロフィールを表示する
プレイリストを作成する
プレイリストにトラックを追加する
パーソナライズされた音楽のおすすめを受け取る

Related MCP server: Spotify MCP Server

利用可能なツール

ツール名	説明
`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";

次に、認証スクリプトを実行します。

node spotify-auth.js

これにより、次のようになります。

ブラウザでURLを開く
Spotifyにログインするように促す
アカウントにアクセスする許可を求める
トークンをsecrets.jsonに保存する

5. MCPサーバーを構築する

npm run build

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が再起動した場合は、資格情報を再度設定する必要があります。

One-click Deploy

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Spotify MCP Server