qemu-mcp — Claude Code MCP server: features and install
An MCP server for Claude Code lets an agent boot and control QEMU virtual machines. It can load an ISO or kernel, send keyboard input, and inspect the display or serial console.
MIT ★ 5 updated 2026-11-16
claude mcp add qemu-mcp -- uvx qemu-mcpWhat qemu-mcp does
qemu-mcp starts QEMU without a graphical window and exposes controls for the guest VM. An agent can boot an ISO, kernel, or disk, press keys, enter text, capture the display, and read or write serial-console data. It can also wait for a chosen string in serial output, such as a kernel-ready marker.
The guest does not need an agent or network connection; control goes through QEMU. QEMU and uvx are needed to run the server, while disk creation uses the separate qemu-img tool. VM snapshots are supported, and saving one requires a qcow2 disk.
What it helps with
- boot an ISO or kernel in QEMU to test startup
- send keyboard input to a virtual machine
- capture a guest display without opening a GUI
- wait for a boot marker in serial output
Example prompts for the agent
- Boot
build/kernelin QEMU and show me a screenshot. - Press
Esc, typehelp, then read the serial console output. - Start the VM and wait for
kernel readyon the serial console.
How to install qemu-mcp
Platform CLI
claude mcp add qemu-mcp -- uvx qemu-mcpuvx runs the command named after the package; if the README names another one, use uvx --from qemu-mcp <command>
Platform CLI
codex mcp add qemu-mcp -- uvx qemu-mcpuvx runs the command named after the package; if the README names another one, use uvx --from qemu-mcp <command>
Config file
{
"mcpServers": {
"qemu-mcp": {
"command": "uvx",
"args": [
"qemu-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from qemu-mcp <command>
Config file
{
"servers": {
"qemu-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"qemu-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from qemu-mcp <command>
Platform CLI
gemini mcp add qemu-mcp uvx qemu-mcpuvx runs the command named after the package; if the README names another one, use uvx --from qemu-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about qemu-mcp
How do I install qemu-mcp in Claude Code?
Run claude mcp add qemu-mcp -- uvx qemu-mcp. QEMU is also needed to start virtual machines.
What does qemu-mcp do?
It starts QEMU virtual machines and lets an agent send keyboard input, capture the display, and use the serial console. The guest does not need an agent or network connection.
What does qemu-mcp require?
It needs QEMU and uvx. Saving VM snapshots requires a qcow2 disk.