MCP Server for Spotify

Spotify 用 MCP サーバー

この MCP サーバーは Spotify API と連携し、Claude を通じてプレイリストを管理・作成できるようにします。

機能

• トラック、アーティスト、アルバムを検索
• プレイリストを作成・変更
• ユーザーのプレイリストを閲覧
• トラック、アーティスト、ジャンルに基づくおすすめを取得

認証の設定

1. Spotify Developer Dashboard で Spotify アプリを作成します
2. リダイレクト URI を http://localhost:8888/callback に設定します
3. 同梱の認証アプリを使ってリフレッシュトークンを取得します：

# Go to the auth-app directory
cd auth-app

# Install dependencies
npm install

# Run the auth app
npm start

4. ブラウザーの指示に従って認証し、リフレッシュトークンを取得します

5. 必要な環境変数を設定します：

export SPOTIFY_CLIENT_ID="your-client-id"
export SPOTIFY_CLIENT_SECRET="your-client-secret"
export SPOTIFY_REFRESH_TOKEN="your-refresh-token"

サーバーの実行

必要な環境変数を設定したら、サーバーを実行できます：

# From the root directory
npm install
npm run build
node dist/index.js

Docker の使用

Docker を使ってサーバーをビルドし、実行することもできます：

# Build the Docker image
podman build -t mcp/spotify -f src/spotify/Dockerfile .

# Run the container with environment variables
podman run -e SPOTIFY_CLIENT_ID="your-client-id" \
  -e SPOTIFY_CLIENT_SECRET="your-client-secret" \
  -e SPOTIFY_REFRESH_TOKEN="your-refresh-token" \
  mcp/spotify

Claude での使用

以下をサーバーの設定に追加します

{
  "mcpServers": {
    "spotify": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOTIFY_CLIENT_ID=your-client-id",
        "-e",
        "SPOTIFY_CLIENT_SECRET=your-client-secret",
        "-e",
        "SPOTIFY_REFRESH_TOKEN=your-refresh-token",
        "mcp/spotify"
      ]
    }
  }
}

プロンプト

MCP サーバーが起動すると、Claude は次のことに利用できます：

1. Spotify で音楽を検索する
2. テーマやジャンルに基づいてプレイリストを作成する
3. プレイリストにトラックを追加する
4. 既存のプレイリストを確認する
5. 音楽の好みに基づくおすすめを取得する

Claude にプレイリストの作成や音楽の検索を依頼するだけで、MCP サーバーを通じて適切な Spotify API ツールを利用します。