Bond MCP Server

Instructions

Implementation Reference

• src/bond_mcp/server.py:156-183 (handler)

  The async handler function for the 'set_fan_speed' MCP tool. It performs input validation, interacts with the Bond client to set the fan speed, and handles errors appropriately.

  @mcp.tool()
  async def set_fan_speed(device_id: str, speed: int) -> Dict[str, Any]:
      """Set fan speed for a ceiling fan device.
      
      Args:
          device_id: The Bond fan device identifier
          speed: Fan speed level (0-8, where 0 is off)
          
      Returns:
          Result of the speed change operation.
      """
      if not (0 <= speed <= 8):
          return {"error": "Fan speed must be between 0 and 8"}
      
      try:
          async with await get_bond_client() as client:
              result = await client.set_speed(device_id, speed)
              return {
                  "device_id": device_id,
                  "speed": speed,
                  "action": "off" if speed == 0 else f"set to speed {speed}",
                  "result": result
              }
      except BondAPIError as e:
          return {"error": f"Failed to set fan speed: {str(e)}"}
      except Exception as e:
          logger.error(f"Unexpected error setting fan speed: {e}")
          return {"error": f"Unexpected error: {str(e)}"}