Sonos

🚀 Sonos MCP 服務器

Sonos MCP 服務器是一個基於 Sonos MCP（模型上下文協議）的項目，它能讓你輕鬆控制並與網絡中的 Sonos 設備進行交互。通過該服務器，你可以發現設備、控制播放狀態、檢索設備狀態以及管理播放隊列。

🚀 快速開始

Sonos MCP 服務器允許你控制和與網絡中的 Sonos 設備交互。以下是快速開始使用該服務器的步驟。

✨ 主要特性

• 發現網絡中的 Sonos 設備
• 檢索和控制設備的播放狀態
• 管理播放隊列
• 作為 MCP 工具公開功能

📦 安裝指南

環境要求

• Python 3.7+
• uv 用於管理 Python 項目

安裝步驟

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

使用 SSE 通過 supergateway 工具運行服務器：

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

要在 SSE 開發模式下運行服務器，請使用 supergateway 的 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：管理隊列中曲目的位置。

📄 許可證

該項目根據 MIT License 許可。有關詳細信息，請參閱 LICENSE 文件。