Bond MCP Server

Instructions

Implementation Reference

• src/bond_mcp/server.py:295-320 (handler)

  The handler function for the 'send_custom_action' tool, registered via @mcp.tool(). It sends a custom action to a Bond device using the BondClient, handling errors and returning results.

  @mcp.tool()
  async def send_custom_action(device_id: str, action: str, argument: Optional[int] = None) -> Dict[str, Any]:
      """Send a custom action to a Bond device.
      
      Args:
          device_id: The Bond device identifier
          action: Bond action name (e.g., "TurnOn", "TurnOff", "SetSpeed")
          argument: Optional argument for the action
          
      Returns:
          Result of the custom action.
      """
      try:
          async with await get_bond_client() as client:
              result = await client.send_action(device_id, action, argument)
              return {
                  "device_id": device_id,
                  "action": action,
                  "argument": argument,
                  "result": result
              }
      except BondAPIError as e:
          return {"error": f"Failed to send custom action: {str(e)}"}
      except Exception as e:
          logger.error(f"Unexpected error sending custom action: {e}")
          return {"error": f"Unexpected error: {str(e)}"}