splunk-mcp

Spotify MCP サーバー

Spotify と連携する Model Context Protocol（MCP）サーバーです。Claude などの AI アシスタントが Spotify アカウントを操作し、やり取りできるようにします。

概要

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

• プレイリストを検索する
• プレイリストの詳細とトラックを取得する
• 再生を操作する（再生、一時停止、スキップ、前のトラック）
• プレイリストを作成、編集する
• シャッフルモードを切り替える
• 現在再生中のトラックを表示する
• トラックをキューに追加する

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 Developer の認証情報

Spotify API 認証情報の取得

1. Spotify Developer Dashboard にアクセスします
2. Spotify アカウントでログインします
3. 「Create an App」をクリックします
4. アプリケーション名と説明を入力します
5. 作成すると、Client ID が表示され、Client Secret を確認できます
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 - Spotify のキューで次のトラックにスキップします
• previous_track - Spotify のキューで前のトラックにスキップします
• 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 - Spotify ユーザーのプレイリストを取得します

検索

• simple_playlist_and_album_search - 名前でプレイリストまたはアルバムを検索します
• simple_song_search - 名前で曲を検索します

ライセンス

MIT ライセンス

謝辞

• zmb3/spotify Golang SDK を使用して構築されています
• Model Context Protocol を実装しています
• 拡大を続ける MCP サーバーのエコシステムに着想を得ています

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。