MCP Wyze Server

Instructions

Implementation Reference

• src/mcp_wyze_server/server.py:192-231 (handler)

  The core handler function for the 'wyze_set_brightness' tool, decorated with @mcp.tool() for automatic registration. Validates input brightness (0-100), retrieves Wyze client, finds device by MAC, confirms light type support, and executes brightness adjustment via wyze-sdk's bulbs.set_brightness method. Handles various errors gracefully.

  @mcp.tool()
  def wyze_set_brightness(device_mac: str, brightness: int) -> Dict[str, str]:
      """Set brightness for a Wyze light (0-100)"""
      try:
          if not 0 <= brightness <= 100:
              return {"status": "error", "message": "Brightness must be between 0 and 100"}
          
          client = get_wyze_client()
          devices = client.devices_list()
          
          for device in devices:
              if device.mac == device_mac:
                  # Get device type - try multiple approaches
                  device_type = (getattr(device, 'product_type', None) or 
                                getattr(device, 'type', None) or
                                (hasattr(device, 'product') and getattr(device.product, 'type', None)) or
                                'Unknown')
                  
                  device_model = (getattr(device, 'product_model', None) or
                                 getattr(device, 'model', None) or
                                 (hasattr(device, 'product') and getattr(device.product, 'model', None)) or
                                 'Unknown')
                  
                  if device_type in ['Light', 'Bulb', 'MeshLight', 'LightStrip']:
                      client.bulbs.set_brightness(
                          device_mac=device_mac, 
                          device_model=device_model, 
                          brightness=brightness
                      )
                      return {"status": "success", "message": f"Set {device.nickname} brightness to {brightness}%"}
                  else:
                      return {"status": "error", "message": f"Device {device.nickname} does not support brightness control"}
          
          return {"status": "error", "message": f"Device with MAC {device_mac} not found"}
      except WyzeClientConfigurationError as e:
          return {"status": "error", "message": f"Configuration error: {str(e)}"}
      except WyzeRequestError as e:
          return {"status": "error", "message": f"API error: {str(e)}"}
      except Exception as e:
          return {"status": "error", "message": f"Unexpected error: {str(e)}"}

• src/mcp_wyze_server/server.py:21-45 (helper)

  Helper function to lazily initialize and retrieve the global Wyze SDK Client instance, using environment variables for authentication. Essential for all Wyze API calls in the tools.

  def get_wyze_client() -> Client:
      """Get or create Wyze client instance with auto-login if credentials available"""
      global _wyze_client
      
      if _wyze_client is None:
          # Get credentials from environment
          email = os.getenv("WYZE_EMAIL")
          password = os.getenv("WYZE_PASSWORD")
          key_id = os.getenv("WYZE_KEY_ID")
          api_key = os.getenv("WYZE_API_KEY")
          
          if not all([email, password, key_id, api_key]):
              raise WyzeClientConfigurationError(
                  "Missing required environment variables: WYZE_EMAIL, WYZE_PASSWORD, WYZE_KEY_ID, WYZE_API_KEY"
              )
          
          _wyze_client = Client(
              email=email,
              password=password,
              key_id=key_id,
              api_key=api_key
          )
      
      return _wyze_client