Spotify MCP

🚀 Spotify MCP Server

このサーバーは、Claudeを介してSpotifyとやり取りできるシンプルなモデルコンテキストプロトコル（MCP）サーバーです。ClaudeがあなたのSpotifyアカウントを使って、曲の検索、プレイリストの作成、レコメンドの取得などを行えるようにします。

✨ 主な機能

• Spotifyで曲を検索する
• あなたのSpotifyプロファイルを表示する
• プレイリストを作成する
• プレイリストに曲を追加する
• パーソナライズされた音楽レコメンドを取得する

🛠️ 利用可能なツール

📦 インストール

1. 前提条件

• Node.js v16以上
• npm
• Spotifyアカウント
• 登録済みのSpotify Developerアプリケーション

2. Spotify Developerアプリを作成する

1. Spotify Developer Dashboardにアクセスする
2. Spotifyアカウントでログインする
3. 「Create an App」をクリックする
4. アプリ名と説明を入力する
5. http://localhost:8888/callbackをリダイレクトURIとして追加する
6. クライアントIDとクライアントシークレットをメモする

3. プロジェクトをインストールする

# まずプロジェクトをクローンまたはダウンロードする
cd spotify-mcp-server

# 依存関係をインストールする
npm install

4. Spotifyトークンを取得する

spotify-auth.jsファイルを編集して、クライアントIDとクライアントシークレットを含めます。

// これらをあなたのSpotifyアプリの資格情報に置き換える
const CLIENT_ID = "your_client_id_here";
const CLIENT_SECRET = "your_client_secret_here";

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

node spotify-auth.js

これにより、以下のことが行われます。

1. ブラウザでURLが開きます。
2. Spotifyにログインするように促されます。
3. アカウントへのアクセス許可を求められます。
4. トークンがsecrets.jsonに保存されます。

5. MCPサーバーをビルドする

npm run build

6. Claude Desktopを設定する

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を閉じて再度開き、新しい設定を読み込みます。

💻 使用例

基本的な使用法

Claudeと会話を始めるときは、まずSpotifyの資格情報を設定する必要があります。

1. secrets.jsonファイルを見て、資格情報を取得します。
2. set-spotify-credentialsツールを使用して認証します。
3. その後、他のSpotifyツールを使用します。

資格情報の設定

私のSpotifyアカウントに接続したいです。secrets.jsonからの資格情報は次のとおりです。

Tool: set-spotify-credentials
Parameters:
{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "accessToken": "your_access_token",
  "refreshToken": "your_refresh_token"
}

基本コマンド

アカウントを確認する：

私がSpotifyで誰としてログインしているかを確認できますか？

Tool: get-current-user
Parameters: {}

曲を検索する：

Weekendの曲を検索してください。

Tool: search-tracks
Parameters:
{
  "query": "Taylor Swift",
  "limit": 5
}

プレイリストを作成する：

「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"
}

多段階タスク

曲付きのプレイリストを作成する：

エネルギッシュな曲でワークアウト用のプレイリストを作成したいです。まず、エネルギッシュな曲をいくつか検索してください。次に、「Workout Mix」という名前のプレイリストを作成し、それらの曲を追加してください。

お気に入りに基づいてレコメンドを取得する：

私はThe Weekndの「Blinding Lights」という曲が好きです。それを検索して、似たような曲を見つけ、それらのレコメンドでプレイリストを作成できますか？

🛠️ トラブルシューティング

• エラー: No access token available：set-spotify-credentialsツールを使用してまず資格情報を設定する必要があります。
• 認証失敗：トークンが期限切れになっている可能性があります。認証スクリプトを再度実行して、新しいトークンを取得してください。
• 無効な資格情報：使用しているクライアントIDとクライアントシークレットが正しいことを再度確認してください。

📝 注意事項

• サーバーは資格情報をメモリにのみ保存します。
• 新しい会話を開始するたびに、資格情報を設定する必要があります。
• Claude Desktopが再起動された場合、再度資格情報を設定する必要があります。