Sonos MCP 服务器

本项目是一个 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

SSE with Supergateway

使用 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

此命令会托管一个 MCP Inspector，用于测试和调试。

要在开发模式下使用 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: 检索 Sonos 设备的当前曲目信息。
• volume: 获取或设置 Sonos 设备的音量。
• skip, play_index, remove_index_from_queue: 管理 Sonos 设备队列中的曲目。

许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。