power_vm

Instructions

Implementation Reference

• vmware_fusion_mcp/server.py:41-46 (handler)

  Core handler logic for the power_vm tool: instantiates a VMwareClient using environment credentials and delegates to its power_vm method to execute the power action.

  async def _power_vm_impl(vm_id: str, action: str) -> Dict[str, Any]:
      """Perform a power action on a VM. Valid actions are 'on', 'off', 'shutdown', 'suspend', 'pause', 'unpause'."""
      async with VMwareClient(username=VMREST_USER, password=VMREST_PASS) as client:
          result = await client.power_vm(vm_id, action)
          return result  # type: ignore[no-any-return]

• vmware_fusion_mcp/server.py:48-51 (registration)

  Registers the power_vm tool in the FastMCP server with input parameters vm_id and action, and docstring describing usage.

  @mcp.tool
  async def power_vm(vm_id: str, action: str) -> Dict[str, Any]:
      """Perform a power action on a VM. Valid actions are 'on', 'off', 'shutdown', 'suspend', 'pause', 'unpause'."""
      return await _power_vm_impl(vm_id, action)

• vmware_fusion_mcp/vmware_client.py:112-159 (helper)

  Key helper method in VMwareClient that implements the power operation: validates the action, constructs and sends a PUT request to the Fusion REST API endpoint /api/vms/{vm_id}/power, handles authentication, parameters, responses, and errors.

  async def power_vm(
      self, vm_id: str, action: str, vm_password: Optional[str] = None
  ) -> Dict[str, Any]:
      """Perform a power action on a VM.
  
      Args:
          vm_id: The ID of the VM
          action: Power action (on, off, shutdown, suspend, pause, unpause)
          vm_password: The password for the VM (if required)
  
      Returns:
          Dictionary with the result of the power action
      """
      valid_actions = ["on", "off", "shutdown", "suspend", "pause", "unpause"]
      if action not in valid_actions:
          raise ValueError(
              f"Invalid action '{action}'. Valid actions: {valid_actions}"
          )
  
      try:
          url = f"{self.base_url}/api/vms/{vm_id}/power"
          params = {}
          if vm_password:
              params["vmPassword"] = vm_password
          headers = self._auth_header.copy()
          headers["Content-Type"] = "application/vnd.vmware.vmw.rest-v1+json"
          response = await self._client.put(
              url,
              headers=headers,
              params=params or None,
              content=action.encode(),
          )
          response.raise_for_status()
          return (
              response.json()
              if response.content
              else {"status": "success", "action": action}
          )
      except httpx.RequestError as e:
          raise Exception(f"Failed to connect to VMware Fusion API: {e}")
      except httpx.HTTPStatusError as e:
          if e.response.status_code == 404:
              raise Exception(f"VM with ID '{vm_id}' not found")
          raise Exception(
              f"VMware Fusion API error: {e.response.status_code} - "
              f"{e.response.text}"
          )

• vmware_fusion_mcp/vmware_client.py:125-129 (schema)

  Input schema validation for the action parameter, enforcing allowed power actions.

  valid_actions = ["on", "off", "shutdown", "suspend", "pause", "unpause"]
  if action not in valid_actions:
      raise ValueError(
          f"Invalid action '{action}'. Valid actions: {valid_actions}"
      )