Sonos MCP Server

🚀 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）

標準入出力を使用してサーバーを起動します：

uv run mcp run server.py

SSE を使用して超ゲートウェイと一緒に使用する

supergateway ツールを使用して SSE 経由でサーバーを起動します：

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

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

./npx-serve-sse-8000.sh

開発

「開発」モードでサーバーを起動し、MCP Inspector を使用してテストおよびデバッグを行います：

uv run mcp dev server.py

2 番目のターミナルウィンドウで以下のコマンドを実行し、SSE モードで開発を行います：

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：Sonos デバイスのキュー内の曲を管理します。

📄 ライセンス

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