Sonos MCP Server

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

Requisitos

• Python 3.7+
• uv para gestionar proyectos de Python

Instalación

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

Uso

Ejecución del servidor

Estudio

Ejecute el servidor usando stdio:

SSE con Supergateway

Ejecute el servidor con SSE usando la herramienta supergateway :

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

Desarrollo

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

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:

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.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.