Sonos MCP Server
Sonos MCP 服务器
该项目是一个 Sonos MCP(模型上下文协议)服务器,允许您控制并与网络上的 Sonos 设备交互。它提供各种功能,例如发现设备、控制播放、检索设备状态和管理队列。
特征
发现网络上的 Sonos 设备
检索和控制设备的播放状态
管理播放队列
将功能公开为 MCP 工具
Related MCP server: YARR Media Stack MCP Server
要求
Python 3.7+
uv用于管理 Python 项目
安装
克隆存储库:
git clone https://github.com/WinstonFassett/sonos-mcp-server.git cd sonos-mcp-server使用
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此命令承载 MCP 检查器以用于测试和调试目的。
要在开发模式下使用 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文件。
Available Tools
18 toolsget_all_device_statesB
Retrieve the state information for all discovered Sonos devices.
Returns: List[Dict[str, Any]]: A list of dictionaries containing state information for each device.
Inputs: no named parameters.
get_current_track_infoA
Retrieve current track information for a Sonos device.
Args: name: The name of the device to retrieve track information from. If None, uses the current device.
Returns: Dict[str, str]: A dictionary containing the current track's artist, title, album, playlist position, and duration.
Inputs: name.
get_device_stateA
Retrieve the state information for a specific Sonos device.
Args: name: The name of the device to retrieve state information for. If None, uses the current device.
Returns: Dict[str, Any]: A dictionary containing the device's name, volume, state, and current track information.
Inputs: name.
get_queueA
Retrieve the queue of tracks for a Sonos device.
Args: name: The name of the device to retrieve the queue from. If None, uses the current device.
Returns: List[Dict[str, Any]]: A list of dictionaries containing track information in the queue.
Inputs: name.
get_queue_lengthB
Retrieve the queue length for a Sonos device.
Args: name: The name of the device to retrieve the queue length from. If None, uses the current device.
Returns: int: The length of the queue.
Inputs: name.
modeA
Get or set the play mode of a Sonos device.
Args: mode: The play mode to set (e.g., "NORMAL", "SHUFFLE_NOREPEAT", "SHUFFLE", "REPEAT_ALL"). If None, returns the current mode. name: The name of the device to set the mode for. If None, uses the current device.
Returns: str: The current play mode after the operation.
Inputs: mode, name.
nextA
Skip to the next track on a Sonos device.
Args: name: The name of the device to skip the track on. If None, uses the current device.
Returns: Dict[str, Any]: The device's state after skipping to the next track, including name, volume, state, and track info.
Inputs: name.
now_playingB
Retrieve information about currently playing tracks on all Sonos devices.
Returns: List[Dict[str, str]]: A list of dictionaries containing the name, title, artist, and album of currently playing tracks.
Inputs: no named parameters.
partymodeA
Enable party mode on the current Sonos device.
Returns: Dict[str, Any]: The device's state after enabling party mode, including name, volume, state, and track info.
Inputs: no named parameters.
pauseB
Pause playback on a Sonos device.
Args: name: The name of the device to pause. If None, uses the current device.
Returns: Dict[str, Any]: The device's state after pausing, including name, volume, state, and track info.
Inputs: name.
playA
Start playback on a Sonos device.
Args: name: The name of the device to start playback on. If None, uses the current device.
Returns: Dict[str, Any]: The device's state after starting playback, including name, volume, state, and track info.
Inputs: name.
play_indexA
Play a specific track from the queue on a Sonos device.
Args: index: The index of the track to play. name: The name of the device to play the track on. If None, uses the current device.
Returns: Dict[str, Any]: The device's state after playing the specified track, including name, volume, state, and track info.
Raises: ValueError: If the index is out of the queue's range.
Inputs: index (required), name.
previousA
Skip to the previous track on a Sonos device.
Args: name: The name of the device to skip the track on. If None, uses the current device.
Returns: Dict[str, Any]: The device's state after skipping to the previous track, including name, volume, state, and track info.
Inputs: name.
remove_index_from_queueA
Remove a specific track from the queue on a Sonos device.
Args: index: The index of the track to remove. name: The name of the device to remove the track from. If None, uses the current device.
Returns: List[Dict[str, Any]]: The updated queue after removing the track.
Raises: ValueError: If the index is out of the queue's range.
Inputs: index (required), name.
skipA
Skip tracks in the queue for a Sonos device.
Args: increment: The number of tracks to skip forward. Defaults to 1. name: The name of the device to skip tracks on. If None, uses the current device.
Returns: Dict[str, Any]: The device's state after skipping tracks, including name, volume, state, and track info.
Raises: ValueError: If the new track position is out of the queue's range.
Inputs: increment, name.
speaker_infoB
Retrieve speaker information for a Sonos device.
Args: name: The name of the device to retrieve speaker information from. If None, uses the current device.
Returns: Dict[str, str]: A dictionary containing speaker information.
Inputs: name.
stopA
Stop playback on a Sonos device.
Args: name: The name of the device to stop. If None, uses the current device.
Returns: Dict[str, Any]: The device's state after stopping, including name, volume, state, and track info.
Inputs: name.
volumeA
Get or set the volume of a Sonos device.
Args: volume: The volume level to set (0-99). If None, returns current volume. name: The name of the device to control. If None, uses the current device.
Returns: int: The current volume level after the operation.
Raises: ValueError: If volume is not between 0 and 99. ValueError: If the specified device is not found.
Inputs: name, volume.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools have distinct purposes, but some overlap exists. For example, 'skip' and 'next' both advance tracks, though 'skip' offers more flexibility with an increment parameter. 'get_current_track_info' and 'now_playing' both retrieve track info, but 'now_playing' covers all devices while 'get_current_track_info' is per-device. Descriptions help clarify these differences, but minor confusion could occur.
Tool names follow a consistent snake_case pattern throughout, with clear verb_noun structures like 'get_device_state', 'play_index', and 'remove_index_from_queue'. However, there are minor deviations: 'mode' and 'volume' are single-word nouns without verbs, and 'partymode' is a compound word instead of snake_case, slightly breaking the pattern.
With 18 tools, the count is slightly high but reasonable for a Sonos control server, covering device states, playback control, queue management, and settings. It might feel a bit heavy, but each tool serves a specific function without obvious redundancy, making it well-scoped for the domain.
The tool set provides comprehensive coverage for Sonos device management. It includes CRUD-like operations for queue management (get, remove), full playback control (play, pause, stop, next, previous, skip), device state retrieval, volume and mode settings, and specialized functions like party mode. No significant gaps are apparent for core audio control workflows.
Maintenance
Related MCP Connectors
Sonos MCP server: control your Sonos speakers from any MCP client. Play songs, artists and playlists, set volume, group rooms, move music to another room, switch to TV, spoken announcements and reminders. 27 tools, English and Chinese. Works through the official Sonos cloud, so there is no home bridge to install; sign in with OAuth. Requires the free ZoneFoundry iOS app.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for Yoto: manage cards, tracks, icons and family devices from any MCP client.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Related MCP Servers
- AlicenseBqualityCmaintenanceA server that enables interaction with Home Assistant devices and automations through the Model Context Protocol, allowing users to monitor device states, control devices, trigger automations, and list entities.448MIT
- AlicenseNot gradedqualityCmaintenanceA comprehensive Model Context Protocol server that bridges LLMs with self-hosted media services, enabling natural language control of TV shows, movies, downloads, and notifications while maintaining traditional API access.17AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for seamless integration with peripheral devices connected to your computer. Control, monitor, and manage hardware devices through a unified API.5MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables interaction with HomeyPro home automation systems, providing paginated access to devices, zones, and flows with comprehensive management capabilities.9-