5 v0.1.0 更新于 2026-11-07
qemu-mcp MCP Server
让 AI 智能体启动并操控 QEMU 虚拟机:按键、截图、串口。无需 guest agent。
适用客户端
本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
安装配置
本地运行(pypi)
{
"mcpServers": {
"qemu-mcp": {
"command": "uvx",
"args": [
"qemu-mcp"
]
}
}
}将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。
提供的工具 接入后 Agent 可调用这 20 个工具
qemu_boot
无头启动一个QEMU虚拟机,支持ISO、内核或磁盘等多种配置
qemu_version
报告已安装的qemu-system版本信息
qemu_disk_create
通过qemu-img create创建新的磁盘镜像
qemu_screenshot
捕获客户机显示器的PNG截图
qemu_type
模拟键盘输入文本
qemu_key
模拟按键或组合键
qemu_mouse
移动绝对指针并可选点击、滚轮等鼠标操作
qemu_pause
暂停虚拟机执行而不退出QEMU
qemu_resume
恢复之前暂停的虚拟机
qemu_snapshot_save
以指定标签保存完整的内存和设备快照
qemu_snapshot_load
恢复虚拟机到之前保存的快照
qemu_snapshot_delete
删除已保存的快照标签并释放空间
qemu_snapshot_list
列出qcow2磁盘上保存的快照标签
qemu_change_media
不重启虚拟机的情况下更换可移动驱动器中的介质
qemu_serial
查看串行控制台(COM1)输出日志
qemu_serial_send
向串行控制台(COM1)写入文本
qemu_wait_serial
阻塞等待指定文本出现在串口输出中或超时
qemu_wait_screen
阻塞等待显示器停止变化或超时
qemu_list
列出所有管理的虚拟机及其状态信息
qemu_stop
优雅地ACPI关机或强制终止虚拟机