Splunk MCP Q0y

🚀 Spotify MCP サーバー

Spotify 統合用の Model Context Protocol (MCP) サーバーです。Claude などの AI アシスタントが Spotify アカウントを制御し、対話できるようにします。

🚀 クイックスタート

このサーバーは、Spotify と AI アシスタントを接続するための MCP サーバーです。AI アシスタントが Spotify アカウントを制御し、対話できるようにします。

✨ 主な機能

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

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

このサーバーは、Model Context Protocol と zmb3/spotify Golang SDK をベースに構築されています。

📚 ドキュメント

何は MCP ですか？

Model Context Protocol (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 Desktop と一緒に使用するには、次の手順を実行します。

1. Claude 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 Desktop を再起動します。
5. Spotify ツールを初めて使用するときは、spotify_login ツールを使用して認証する必要があります。

💻 使用例

利用可能なツール

再生

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

再生リスト

• get_playlist - 特定の再生リストの詳細を取得します。
• get_playlist_tracks - 再生リストの曲を取得します。
• create_playlist - 新しい Spotify 再生リストを作成します。
• add_tracks_to_playlist - 再生リストに曲を追加します。
• remove_tracks_from_playlist - 再生リストから曲を削除します。
• get_user_playlists - ユーザーのすべての再生リストを取得します。

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。詳細については、MIT License を参照してください。

貢献ガイド

このプロジェクトに貢献したい場合は、Contributing Guide を参照して、プロジェクトへの参加方法を確認してください。