Sonos MCP Server

🚀 Sonos MCP 服務器

該項目是一個 Sonos MCP（模型上下文協議）服務器，可讓您對網絡中的 Sonos 設備進行控制與交互。它具備設備發現、播放狀態控制、設備狀態檢索以及隊列管理等實用功能。

🚀 快速開始

本服務器允許您控制和交互網絡中的 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）

使用標準輸入輸出運行服務器：

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

在第二個終端窗口中運行以下命令，以 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 文件。