Servidor Sonos MCP

Este proyecto es un servidor MCP (Protocolo de Contexto de Modelo) de Sonos que permite controlar e interactuar con dispositivos Sonos en la red. Ofrece diversas funcionalidades, como la detección de dispositivos, el control de la reproducción, la consulta del estado de los dispositivos y la gestión de colas.

Características

Descubra los dispositivos Sonos en la red
Recuperar y controlar el estado de reproducción de los dispositivos
Administrar colas de reproducción
Exponer funcionalidades como herramientas MCP

Related MCP server: MCP SNS Server

Requisitos

Python 3.7+
uv para gestionar proyectos de Python

Instalación

Clonar el repositorio:
git clone https://github.com/WinstonFassett/sonos-mcp-server.git cd sonos-mcp-server
Instale las dependencias necesarias usando uv :
uv sync

Uso

Ejecución del servidor

Estudio

Ejecute el servidor usando stdio:

uv run mcp run server.py

SSE con Supergateway

Ejecute el servidor con SSE usando la herramienta supergateway :

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

Alternativamente, puede utilizar el script de conveniencia proporcionado en el repositorio:

./npx-serve-sse-8000.sh

Desarrollo

Para ejecutar el servidor en modo "desarrollo" con el Inspector MCP:

uv run mcp dev server.py

Este comando aloja un inspector MCP para fines de prueba y depuración.

Para ejecutar el servidor con SSE en modo de desarrollo, utilice el comando SSE para supergateway y, en una segunda ventana de terminal, ejecute:

npx @modelcontextprotocol/inspector

Herramientas MCP disponibles

Utilice las herramientas MCP expuestas para interactuar con dispositivos Sonos. Las herramientas disponibles incluyen:

get_all_device_states : recupera la información del estado de todos los dispositivos Sonos descubiertos.
now_playing : recupera información sobre las pistas que se están reproduciendo actualmente en todos los dispositivos Sonos.
get_device_state : recupera la información de estado de un dispositivo Sonos específico.
pause , stop , play : controla la reproducción en un dispositivo Sonos.
next , previous : Saltar pistas en un dispositivo Sonos.
get_queue , get_queue_length : administra la cola de reproducción de un dispositivo Sonos.
mode : obtener o configurar el modo de reproducción de un dispositivo Sonos.
partymode : habilita el modo fiesta en el dispositivo Sonos actual.
speaker_info : recupera información de los altavoces de un dispositivo Sonos.
get_current_track_info : recupera información de la pista actual de un dispositivo Sonos.
volume : obtiene o configura el volumen de un dispositivo Sonos.
skip , play_index , remove_index_from_queue : administra pistas en la cola de un dispositivo Sonos.