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";

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

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

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

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

Spotify MCP Server
varunneal
A
security
F
license
A
quality
A 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 -
4
273
Python
Spotify MCP Server
jamiew
A
security
F
license
A
quality
Connects Claude with Spotify, allowing users to control playback, search for content, get music information, and manage the Spotify queue.
Last updated -
8
1
Python
Spotify MCP Server
boristopalov
-
security
F
license
-
quality
Connects Claude with Spotify, enabling playback control, search functionality, and queue management through Spotify's API.
Last updated -
Python
Spotify MCP Server
Naunau75
-
security
F
license
-
quality
Connects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.
Last updated -
Python

View all related MCP servers

Spotify MCP Server