Spotify MCP Server Mdr

🚀 Spotify MCP サーバー

このサーバーは、Spotify 統合のためのモデルコンテキストプロトコル（MCP）サーバーです。AI アシスタント（Claude など）が Spotify アカウントを制御し、それと対話できるようにします。

🚀 クイックスタート

このプロジェクトは、AI アシスタントが以下の操作を行えるようにする MCP ツールを提供します。

• 再生リストを検索する
• 再生リストの詳細情報と曲を取得する
• 再生を制御する（再生、一時停止、次の曲、前の曲）
• 再生リストを作成および変更する
• シャッフルモードを切り替える
• 現在再生中の曲を確認する
• 曲をキューに追加する

このサーバーは、モデルコンテキストプロトコル と zmb3/spotify Golang SDK に基づいて構築されています。

✨ 主な機能

主な機能の概要

このプロジェクトは、AI アシスタントが以下の操作を行えるようにする MCP ツールを提供します。

• 再生リストを検索する
• 再生リストの詳細情報と曲を取得する
• 再生を制御する（再生、一時停止、次の曲、前の曲）
• 再生リストを作成および変更する
• シャッフルモードを切り替える
• 現在再生中の曲を確認する
• 曲をキューに追加する

什么是 MCP？

モデルコンテキストプロトコル（MCP）は、アプリケーションが大規模言語モデル（LLM）にコンテキストを提供する方法を標準化するオープンプロトコルです。Claude などの LLM が安全かつ標準的な方法で外部システムやデータソースと対話できるようにします。

MCP は、AI アプリケーションの USB - C ポートのようなもので、AI モデルをさまざまなデータソースやツールに標準的な方法で接続します。このプロジェクトは、MCP 仕様に準拠した Spotify サーバーを実装し、AI アシスタントが Spotify アカウントを制御し、それと対話できるようにします。

📦 インストール

前提条件

1. Go 1.18 以上
2. Spotify アカウント（再生制御を行うには Spotify Premium が必要）
3. Spotify 開発者認証情報

Spotify API 認証情報の取得

1. Spotify 開発者ダッシュボード にアクセスします。
2. Spotify アカウントでログインします。
3. 「アプリを作成」をクリックします。
4. アプリケーションの名前と説明を入力します。
5. 作成が完了すると、クライアント ID が表示され、クライアントシークレット を確認できます。
6. リダイレクト URI を http://127.0.0.1:1690/callback に設定します。

Claude との連携

このサーバーを Claude for Desktop と連携するには、以下の手順を実行します。

1. Claude for Desktop を開きます。
2. 以下の場所にある MCP 設定ファイルを作成または更新します。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
3. 以下の設定を追加します。

{
  "mcpServers": {
    "spotify": {
      "command": "/path/to/spotify-mcp-binary",
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

4. Claude for Desktop を再起動します。
5. Spotify ツールを初めて使用する際には、spotify_login ツールを使用して認証する必要があります。

💻 使用例

利用可能なツール

再生制御

• spotify_login - Spotify の認証プロセスを開始し、再生制御の権限を取得します。
• play - Spotify アカウントで再生を開始または再開します。
• pause - Spotify アカウントで再生を一時停止します。
• next_track - 現在の再生キューの次の曲にジャンプします。
• previous_track - 現在の再生キューの前の曲にジャンプします。
• shuffle - Spotify アカウントのシャッフルモードを切り替えます。
• current_track - 現在再生中の曲の情報を取得します。
• get_queue - 現在の再生キューを取得します。
• get_current_playlist - 現在再生中の再生リストを取得します。

再生リスト管理

• create_playlist - 新しい再生リストを作成します。
• add_to_playlist - 曲を再生リストに追加します。
• remove_from_playlist - 曲を再生リストから削除します。
• delete_playlist - 再生リストを削除します。
• get_playlists - 利用可能なすべての再生リストを取得します。

📄 ライセンス

このプロジェクトのソースコードは、MIT License に従っています。