adb_qemu_start
Boot a KVM-accelerated QEMU virtual machine with automatic CPU and RAM sizing, optional safe custom limits, and ADB port forwarding for guest access.
Instructions
Boot a QEMU virtual machine with KVM hardware acceleration. Auto-detects optimal resource allocation: uses total cores minus 1 for the VM (reserving one for the host OS), and up to 65% of physical RAM. Custom values are accepted but capped at safe limits to prevent host starvation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"image": "<image>"
},
"name": "adb_qemu_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cpus | No | Virtual CPUs. Auto-detected if omitted (total cores minus 1). Capped at safe limit. | |
| name | Yes | VM name (used to track and stop the VM) | |
| image | Yes | Disk image filename (from adb_qemu_images) or absolute path | |
| append | No | Kernel command line arguments (for Android boot). | |
| initrd | No | Path to initrd/ramdisk image (for Android boot). | |
| kernel | No | Path to kernel image (for Android boot). If omitted, QEMU uses the disk image's bootloader. | |
| adbPort | No | Host port to forward to guest ADB (port 5555). Default 5556. | |
| display | No | Display output. 'none' for headless (default). 'vnc' starts a VNC server on port 5900. | none |
| memoryMb | No | RAM in MB. Auto-detected if omitted (65% of physical RAM). Capped at safe limit. |