local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides tools for controlling Sonos audio devices, including discovering devices on a network, controlling playback (play, pause, stop, next, previous), managing playback queues, adjusting volume, retrieving now playing information, and enabling party mode across speakers.
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+
uvpara gestionar proyectos de Python
Instalación
- Clonar el repositorio:Copy
- Instale las dependencias necesarias usando
uv:Copy
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.
You must be authenticated.
Un servidor que le permite controlar e interactuar con dispositivos Sonos en su red a través del Protocolo de contexto de modelo, proporcionando funcionalidades para descubrir dispositivos, controlar la reproducción, recuperar estados de dispositivos y administrar colas.