Qemu Mcp
Boot and drive QEMU VMs from an AI agent: keys, screenshots, serial. No guest agent.
- GitHub stars
- 5
- tools
- 23
- transport
- STDIO
- last updated
- Nov 7, 2026
Tools
23 toolsPublic tool metadata for what this MCP can expose to an agent.
qemu_bootBoot a VM headless from iso, kernel (+append/initrd), and/or disk, with optional machine, smp, accel, cpu, hostfwd and extra QEMU args.
Boot a VM headless from iso, kernel (+append/initrd), and/or disk, with optional machine, smp, accel, cpu, hostfwd and extra QEMU args.
No parameter schema in public metadata yet.
qemu_versionReport the installed qemu-system-<arch> --version output, without booting a VM.
Report the installed qemu-system-<arch> --version output, without booting a VM.
No parameter schema in public metadata yet.
qemu_machinesReport qemu-system-<arch> -M help output: every valid qemu_boot machine value for that arch, without booting a VM.
Report qemu-system-<arch> -M help output: every valid qemu_boot machine value for that arch, without booting a VM.
No parameter schema in public metadata yet.
qemu_cpu_modelsReport qemu-system-<arch> -cpu help output: every valid qemu_boot cpu value for that arch, without booting a VM.
Report qemu-system-<arch> -cpu help output: every valid qemu_boot cpu value for that arch, without booting a VM.
No parameter schema in public metadata yet.
qemu_disk_createCreate a fresh disk image via qemu-img create, ready for qemu_boot's disk param.
Create a fresh disk image via qemu-img create, ready for qemu_boot's disk param.
No parameter schema in public metadata yet.
qemu_screenshotPNG of the guest's display, straight from the framebuffer.
PNG of the guest's display, straight from the framebuffer.
No parameter schema in public metadata yet.
qemu_typeType text as keyboard input (\n = Enter, shifted symbols handled, tunable keystroke delay).
Type text as keyboard input (\n = Enter, shifted symbols handled, tunable keystroke delay).
No parameter schema in public metadata yet.
qemu_keyPress a key or chord: enter, esc, f12, ctrl-alt-f2, etc.
Press a key or chord: enter, esc, f12, ctrl-alt-f2, etc.
No parameter schema in public metadata yet.
qemu_mouseMove the absolute pointer and optionally click, scroll, or press side/extra buttons.
Move the absolute pointer and optionally click, scroll, or press side/extra buttons.
No parameter schema in public metadata yet.
qemu_pausePause the VM's execution (QMP stop) without exiting QEMU.
Pause the VM's execution (QMP stop) without exiting QEMU.
No parameter schema in public metadata yet.
qemu_resumeResume a VM previously paused with qemu_pause (QMP cont).
Resume a VM previously paused with qemu_pause (QMP cont).
No parameter schema in public metadata yet.
qemu_snapshot_saveSave a full RAM+device snapshot under a tag (needs a qcow2 disk).
Save a full RAM+device snapshot under a tag (needs a qcow2 disk).
No parameter schema in public metadata yet.
qemu_snapshot_loadRestore a VM to a previously saved snapshot tag.
Restore a VM to a previously saved snapshot tag.
No parameter schema in public metadata yet.
qemu_snapshot_deleteDelete a previously saved snapshot tag, freeing its space in the qcow2 disk.
Delete a previously saved snapshot tag, freeing its space in the qcow2 disk.
No parameter schema in public metadata yet.
qemu_snapshot_listList snapshot tags saved on the VM's qcow2 disk.
List snapshot tags saved on the VM's qcow2 disk.
No parameter schema in public metadata yet.
qemu_change_mediaSwap the medium in a removable drive (e.g. a CD-ROM) without rebooting.
Swap the medium in a removable drive (e.g. a CD-ROM) without rebooting.
No parameter schema in public metadata yet.
qemu_serialTail the serial console (COM1) output, also after the VM has exited.
Tail the serial console (COM1) output, also after the VM has exited.
No parameter schema in public metadata yet.
qemu_serial_sendWrite text to the serial console (COM1).
Write text to the serial console (COM1).
No parameter schema in public metadata yet.
qemu_wait_serialBlock until given text appears on serial, or timeout.
Block until given text appears on serial, or timeout.
No parameter schema in public metadata yet.
qemu_wait_screenBlock until the display stops changing, or timeout.
Block until the display stops changing, or timeout.
No parameter schema in public metadata yet.
qemu_listAll managed VMs with state, arch, machine, hostfwd, pid, uptime.
All managed VMs with state, arch, machine, hostfwd, pid, uptime.
No parameter schema in public metadata yet.
qemu_stopGraceful ACPI powerdown, or force=true to kill.
Graceful ACPI powerdown, or force=true to kill.
No parameter schema in public metadata yet.
qemu_qmpRun any raw QMP command on the VM.
Run any raw QMP command on the VM.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
qemu-mcp
Let your AI agent boot an operating system and drive it.
qemu-mcp is an MCP server that gives AI agents (Claude Code, or any MCP client) hands on a QEMU virtual machine: boot an ISO or a raw kernel, press keys, take screenshots, read the serial console, and wait for boot markers — all headless, with zero cooperation from the guest. No SSH, no guest agent, no network. If it boots in QEMU, an agent can drive it.
MORT OS terminal after the agent typed help — captured through qemu-mcp
This screenshot was taken by an AI agent: it booted MORT OS (a hobby kernel with no SSH, no agent, no TCP required) headless, pressed Esc, typed help, and captured the framebuffer — four tool calls.
Who this is for
Details
- Repository
- github.com/0xmortuex/qemu-mcp
- Category
- AI & LLM Tools
- Package
qemu-mcp- Transport
- STDIO
- Registry
- MCP registry, active
Related AI & LLM Tools MCP servers
View all
HasData Binghasdata/bing-mcpBing search results with the ad block and Copilot answer, geo and market targeting, as JSON.5stars
Silicon Friendlyunlikefraction/silicon-friendlyDirectory rating websites on AI-agent-friendliness. Search, lookup, and submit.5stars
TickerDBtickerdb/tickerdb-mcpPre-computed market data that improves agent reasoning, reduces token usage, and replaces pipelines.5stars
Skill Audit Mcpeltociear/skill-audit-mcpMCP server: static security scanner for MCP servers, agent skills & plugins. 17 attack patterns.5stars
Scrapibamchi/scrapi-mcp-serverWeb scraping for AI agents. Converts URLs to clean, LLM-ready Markdown with anti-bot bypass.5stars
Nucleuseidetic-works/nucleus-mcpPersistent memory for AI agents — shared .brain across Claude Code, Cursor & Codex5stars