list_vms
Retrieve a list of all virtual machines in VMware Fusion using the MCP server, enabling users to efficiently manage and monitor their VM inventory.
Instructions
List all VMs in VMware Fusion.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- vmware_fusion_mcp/server.py:22-25 (handler)MCP tool handler for 'list_vms', registered with @mcp.tool decorator. Delegates to internal helper.@mcp.tool async def list_vms() -> Dict[str, Any]: """List all VMs in VMware Fusion.""" return await _list_vms_impl()
- vmware_fusion_mcp/server.py:15-19 (helper)Helper function that instantiates VMwareClient and calls its list_vms method, wrapping result.async def _list_vms_impl() -> Dict[str, Any]: """List all VMs in VMware Fusion.""" async with VMwareClient(username=VMREST_USER, password=VMREST_PASS) as client: vms = await client.list_vms() return {"vms": vms} # type: ignore[no-any-return]
- Core implementation in VMwareClient that performs HTTP GET to /api/vms endpoint to fetch VM list.async def list_vms(self) -> List[Dict[str, Any]]: """List all VMs. Returns: List of VM dictionaries with basic information """ try: response = await self._client.get( f"{self.base_url}/api/vms", headers=self._auth_header, ) response.raise_for_status() result: List[Dict[str, Any]] = response.json() return result except httpx.RequestError as e: raise Exception(f"Failed to connect to VMware Fusion API: {e}") except httpx.HTTPStatusError as e: raise Exception( f"VMware Fusion API error: {e.response.status_code} - " f"{e.response.text}" )