Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_QEMU_LAB_WORKSPACE | Yes | The absolute path to the directory where mcp-qemu-lab will store its workspace, logs, and artifacts. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ensure_dependencies | Checks and auto-installs host dependencies, prepares workspace, and records versions. |
| vm_create | Create a VM definition, disks, and cloud-init seed image. |
| vm_start | Start a VM and return QMP/SSH endpoints. |
| vm_status | Get VM runtime/QMP/SSH status and log file paths. |
| vm_stop | Stop a VM gracefully or forcefully. |
| vm_snapshot_save | Save a VM snapshot by name via QMP HMP bridge. |
| vm_snapshot_load | Load a VM snapshot by name via QMP HMP bridge. |
| guest_exec | Execute an allowlisted guest command over SSH, with optional per-call unsafe override. |
| guest_copy_out | Copy a file artifact out of the guest and return artifact metadata. |
| guest_copy_in | Copy a host file into the guest filesystem via SCP. |
| process_list | List guest processes with pid, user, and cmdline. |
| process_maps | Return parsed /proc//maps for a guest process. |
| process_dump_core | Generate a process core dump in guest via gdb/gcore and copy artifact out. |
| guest_dump_memory | Dump full guest memory to a host artifact file via QMP. |
| debugger_attach | Create an in-guest debugger session handle for a target PID. |
| debugger_set_breakpoint | Set breakpoint (symbol or address) for a debugger session. |
| debugger_continue | Continue execution for debugger session. |
| debugger_read_registers | Read process registers via in-guest gdb attach. |
| debugger_detach | Detach and mark debugger session inactive. |
| artifacts_list | List artifacts with hashes and provenance. |
| vm_logs_tail | Fetch recent QEMU/serial/debug log tails and related audit lines for a VM. |
| guest_wait_ready | Wait for guest SSH/cloud-init readiness and optional debugger dependencies (gdb). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Artifact Index | JSON index of all artifact metadata records. |