A
securityA
licenseA
qualityA server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.
Last updated -
490
MIT License
Spotify MCP サーバー
Claude を介して Spotify とやり取りできるシンプルな Model Context Protocol (MCP) サーバーです。このサーバーにより、Claude は Spotify アカウントを使って曲を検索したり、プレイリストを作成したり、おすすめの表示などを行うことができます。
特徴
Spotifyでトラックを検索する
Spotifyプロフィールを表示する
プレイリストを作成する
プレイリストにトラックを追加する
パーソナライズされた音楽のおすすめを受け取る
利用可能なツール
ツール名 | 説明 |
| Spotifyの認証情報を設定する |
| 資格情報が有効かどうか、誰がログインしているかを確認します |
| 名前、アーティスト、キーワードでトラックを検索 |
| Spotifyプロフィール情報を取得する |
| アカウントに新しいプレイリストを作成する |
| 既存のプレイリストにトラックを追加する |
| シードトラックに基づいて推奨事項を取得する |
セットアップ手順
1. 前提条件
Node.js v16以上
npm
Spotifyアカウント
登録済みのSpotify開発者アプリケーション
2. 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.jsonWindows の場合:
%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が再起動した場合は、資格情報を再度設定する必要があります。
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Claude が Spotify アカウントを通じて曲を検索したり、プレイリストを作成したり、おすすめの取得や音楽の管理を行ったりして、Spotify を操作できるようになります。
Related MCP Servers
- AsecurityAlicenseAqualityConnects Claude with Spotify, allowing users to control playback, search for content, get music information, and manage the Spotify queue.Last updated -94MIT License
- -securityFlicense-qualityConnects Claude with Spotify, enabling playback control, search functionality, and queue management through Spotify's API.Last updated -4
- -securityFlicense-qualityConnects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.Last updated -1