Sonos

🚀 Sonos MCP サーバー

このプロジェクトは Sonos MCP（モデルコンテキストプロトコル）サーバーで、ネットワーク内の Sonos デバイスを制御し、それらと相互作用することができます。デバイスの発見、再生状態の制御、デバイス状態の取得、キューの管理など、様々な機能を提供します。

✨ 主な機能

• ネットワーク内の Sonos デバイスを発見する
• デバイスの再生状態を取得および制御する
• 再生キューを管理する
• MCP ツールとして機能を公開する

📦 インストール

必要条件

• Python 3.7+
• Python プロジェクトの管理に uv を使用

インストール手順

1. リポジトリをクローンします：

   git clone https://github.com/WinstonFassett/sonos-mcp-server.git
   cd sonos-mcp-server
   

2. uv を使用して必要な依存関係をインストールします：

   uv sync
   

💻 使用例

サーバーの起動

標準入出力（Stdio）

stdio を使用してサーバーを起動します：

uv run mcp run server.py

Supergateway の SSE を使用する

supergateway ツールを通じて SSE を使用してサーバーを起動します：

npx -y supergateway --port 8000 --stdio "uv run mcp run server.py"

または、リポジトリに保存されている便利なスクリプトを使用することもできます：

./npx-serve-sse-8000.sh

開発

「開発」モードでサーバーを起動し、MCP チェッカーを使用します：

uv run mcp dev server.py

このコマンドは、テストおよびデバッグ目的で MCP チェッカーをホストします。

SSE 開発モードでサーバーを起動するには、supergateway の SSE コマンドを使用し、2 番目のターミナルウィンドウで以下を実行します：

npx @modelcontextprotocol/inspector

利用可能な MCP ツール

公開されている MCP ツールを使用して Sonos デバイスとやり取りします。利用可能なツールは以下の通りです：

• get_all_device_states：すべての検出された Sonos デバイスの状態情報を取得します。
• now_playing：すべての Sonos デバイスで現在再生中の情報を取得します。
• get_device_state：特定の Sonos デバイスの状態情報を取得します。
• pause, stop, play：Sonos デバイスの再生状態を制御します。
• next, previous：Sonos デバイスで曲をスキップします。
• get_queue, get_queue_length：Sonos デバイスの再生キューを管理します。
• mode：Sonos デバイスの再生モードを取得または設定します。
• partymode：現在の Sonos デバイスでパーティーモードを有効にします。
• speaker_info：Sonos デバイスのスピーカー情報を取得します。
• get_current_track_info：現在再生中の曲の情報を取得します。
• volume：Sonos デバイスの音量を取得または設定します。
• skip, play_index, remove_index_from_queue：キュー内の曲の位置を管理します。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。