local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables searching for tracks, viewing Spotify profiles, creating and managing playlists, adding tracks to playlists, and getting personalized music recommendations using a Spotify account.

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.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Claude が Spotify アカウントを通じて曲を検索したり、プレイリストを作成したり、おすすめの取得や音楽の管理を行ったりして、Spotify を操作できるようになります。

Appeared in Searches

Microsoft Outlook Application or Email Service