Sonos MCP Server

🚀 Sonos MCP Server

This project is a Sonos MCP (Model Context Protocol) server that allows you to control and interact with Sonos devices on the network. It provides functions such as discovering devices, controlling playback status, retrieving device status, and managing queues.

🚀 Quick Start

The Sonos MCP Server is a powerful tool for interacting with Sonos devices on your network. It offers a range of features to control and manage your Sonos ecosystem.

✨ Features

• Discover Sonos devices on the network.
• Retrieve and control the playback status of devices.
• Manage the playback queue.
• Expose functions as MCP tools.

📦 Installation

Requirements

• Python 3.7+
• uv for managing Python projects

Steps

1. Clone the repository:

   git clone https://github.com/WinstonFassett/sonos-mcp-server.git
   cd sonos-mcp-server
   

2. Install the required dependencies using uv:

   uv sync
   

💻 Usage Examples

Running the Server

Stdio (Standard Input/Output)

Run the server using standard input/output:

uv run mcp run server.py

SSE with Supergateway

Run the server via SSE using the supergateway tool:

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

Alternatively, you can use the convenient script provided in the repository:

./npx-serve-sse-8000.sh

Development

Run the server in "development" mode and use the MCP Inspector for testing and debugging:

uv run mcp dev server.py

In a second terminal window, run the following command for development in SSE mode:

npx @modelcontextprotocol/inspector

Available MCP Tools

Use the exposed MCP tools to interact with Sonos devices. Available tools include:

• get_all_device_states: Retrieve status information for all discovered Sonos devices.
• now_playing: Retrieve information about the currently playing content on all Sonos devices.
• get_device_state: Retrieve status information for a specific Sonos device.
• pause, stop, play: Control the playback status of Sonos devices.
• next, previous: Skip tracks on Sonos devices.
• get_queue, get_queue_length: Manage the playback queue of Sonos devices.
• mode: Get or set the playback mode of Sonos devices.
• partymode: Enable party mode on the current Sonos device.
• speaker_info: Retrieve speaker information for Sonos devices.
• get_current_track_info: Retrieve information about the currently playing track.
• volume: Get or set the volume of Sonos devices.
• skip, play_index, remove_index_from_queue: Manage tracks in the Sonos device queue.

📄 License

This project is open - source under the MIT License. For more details, see the LICENSE file.