VMware Fusion MCP Server

Instructions

Implementation Reference

• vmware_fusion_mcp/server.py:54-59 (handler)

  Core handler implementation that creates a VMwareClient instance and calls its get_vm_power_state method to retrieve the VM power state.

  async def _get_vm_power_state_impl(vm_id: str) -> Dict[str, Any]:
      """Get the power state of a specific VM."""
      async with VMwareClient(username=VMREST_USER, password=VMREST_PASS) as client:
          state = await client.get_vm_power_state(vm_id)
          return state  # type: ignore[no-any-return]

• vmware_fusion_mcp/server.py:61-64 (registration)

  Registers the 'get_vm_power_state' tool with the MCP server via @mcp.tool decorator. The tool handler delegates execution to the private implementation function.

  @mcp.tool
  async def get_vm_power_state(vm_id: str) -> Dict[str, Any]:
      """Get the power state of a specific VM."""
      return await _get_vm_power_state_impl(vm_id)

• vmware_fusion_mcp/vmware_client.py:160-192 (helper)

  Supporting utility in VMwareClient class that performs the HTTP GET request to the Fusion REST API endpoint /api/vms/{vm_id}/power to obtain the power state.

  async def get_vm_power_state(
      self, vm_id: str, vm_password: Optional[str] = None
  ) -> Dict[str, Any]:
      """Get the power state of a specific VM.
  
      Args:
          vm_id: The ID of the VM
          vm_password: The password for the VM (if required)
  
      Returns:
          Dictionary with the VM's power state
      """
      try:
          url = f"{self.base_url}/api/vms/{vm_id}/power"
          params = {}
          if vm_password:
              params["vmPassword"] = vm_password
          response = await self._client.get(
              url,
              headers=self._auth_header,
              params=params or None,
          )
          response.raise_for_status()
          return response.json()  # type: ignore[no-any-return]
      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}"
          )