MCP Server For Spotify

🚀 Spotify MCP サーバー

この MCP サーバーは Spotify API と統合されており、Claude を通じて再生リストの管理と作成を行うことができます。

✨ 主な機能

• 曲、アーティスト、アルバムの検索
• 再生リストの作成と編集
• ユーザーの再生リストの閲覧
• 曲、アーティスト、ジャンルに基づく推薦の取得

📦 インストール

認証設定

1. Spotify 開発者コンソール で Spotify アプリを作成します。
2. リダイレクト URI を http://localhost:8888/callback に設定します。
3. 同梱の認証アプリケーションを使用して、リフレッシュトークンを取得します。

# auth-app ディレクトリに移動
cd auth-app

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

# 認証アプリケーションを実行
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"

サーバーの起動

環境変数を設定したら、以下のコマンドでサーバーを起動できます。

# ルートディレクトリから
npm install
npm run build
node dist/index.js

Docker を使用したサーバーの実行

Docker を使用してサーバーを構築し、実行することもできます。

# Docker イメージを構築
podman build -t mcp/spotify -f src/spotify/Dockerfile .

# 環境変数を指定してコンテナを実行
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 ツールを利用します。