Sonos MCP Server

Instructions

Implementation Reference

• server.py:342-365 (handler)

  The handler function decorated with @mcp.tool() that implements the logic to play a specific track by index from the Sonos queue. It validates the index, skips if already playing, and returns device info.

  @mcp.tool()
  def play_index(index: int, name: Optional[str] = None) -> Dict[str, Any]:
      """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.
      """
      sonos = get_device(name).group.coordinator
      queue_length = sonos.queue_size
      
      if not 0 <= index <= queue_length:
          raise ValueError(f"Index {index} is not within range 1-{queue_length}")
      
      current = int(sonos.get_current_track_info()['playlist_position'])
      if index != current:
          sonos.play_from_queue(index)
      return get_info_from(sonos)

• server.py:342-342 (registration)

  The @mcp.tool() decorator registers the play_index function as an MCP tool.

  @mcp.tool()