Sonos MCP Server

Instructions

Implementation Reference

• server.py:264-274 (handler)

  The core handler function for the 'speaker_info' MCP tool, decorated with @mcp.tool() for registration. It uses the helper get_device to obtain the Sonos device and calls its get_speaker_info() method to return the speaker details as a dictionary.
  @mcp.tool() def speaker_info(name: Optional[str] = None) -> Dict[str, str]: """Retrieve speaker information for a Sonos device. Args: name: The name of the device to retrieve speaker information from. If None, uses the current device. Returns: Dict[str, str]: A dictionary containing speaker information. """ return get_device(name).get_speaker_info()
• server.py:31-61 (helper)

  Supporting helper function get_device that resolves the Sonos device by name (case-insensitive) or defaults to the first/current device, used by the speaker_info handler.
  def get_device(name: Optional[str] = None) -> soco.SoCo: """Retrieve a Sonos device by name or return the current device. Args: name: The name of the device to retrieve. If None, returns the current device. Returns: soco.SoCo: The Sonos device object. Raises: ValueError: If the specified device name is not found. """ global device if not name and device: return device devices = get_devices() if not name: device = devices[list(devices.keys())[0]] return device if name in devices: device = devices[name] return device for key in devices: if key.lower() == name.lower(): device = devices[key] return device raise ValueError(f"Device {name} not found")
• server.py:264-264 (registration)

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