Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add qemu-mcp -- uvx qemu-mcp
Open on GitHub

What 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/kernel in QEMU and show me a screenshot.
  • Press Esc, type help, then read the serial console output.
  • Start the VM and wait for kernel ready on the serial console.

How to install qemu-mcp

Platform CLI

claude mcp add qemu-mcp -- uvx qemu-mcp

uvx 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.

Similar MCP servers

All MCP servers for Testing and QA →

Project sponsors

Companies that keep this analytics open