qemu-mcp — MCP-сервер для Claude Code: запуск и установка
MCP-сервер для Claude Code запускает виртуальные машины QEMU и передаёт агенту управление ими. Агент может загружать ISO или ядро, вводить команды и читать экран либо последовательную консоль.
MIT ★ 5 обновлён 2026-11-16
claude mcp add qemu-mcp -- uvx qemu-mcpЧто делает qemu-mcp
qemu-mcp запускает QEMU без графического окна и даёт агенту инструменты для управления виртуальной машиной. Он может загрузить ISO, ядро или диск, нажимать клавиши, вводить текст, делать снимки экрана и читать либо записывать данные последовательной консоли. Сервер также ждёт заданный текст в выводе консоли — например, маркер готовности ядра.
Виртуальная машина не обязана запускать гостевой агент или иметь сеть: управление идёт через QEMU. Для запуска нужны QEMU и uvx; создание диска выполняется отдельным инструментом через qemu-img. Сервер умеет сохранять снимки состояния, но для этого нужен диск в формате qcow2.
Какие задачи решает
- загрузить ISO или ядро в QEMU для проверки запуска
- вводить команды в виртуальную машину через клавиатуру
- снимать экран гостевой системы без графического окна
- ждать маркер загрузки в последовательной консоли
Примеры запросов агенту
- Загрузи
build/kernelв QEMU и покажи снимок экрана. - Нажми
Esc, введиhelpи прочитай вывод последовательной консоли. - Жди строку
kernel readyв консоли после запуска виртуальной машины.
Как установить qemu-mcp
Командой платформы
claude mcp add qemu-mcp -- uvx qemu-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from qemu-mcp <команда>
Командой платформы
codex mcp add qemu-mcp -- uvx qemu-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from qemu-mcp <команда>
Файл настроек
{
"mcpServers": {
"qemu-mcp": {
"command": "uvx",
"args": [
"qemu-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from qemu-mcp <команда>
Файл настроек
{
"servers": {
"qemu-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"qemu-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from qemu-mcp <команда>
Командой платформы
gemini mcp add qemu-mcp uvx qemu-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from qemu-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о qemu-mcp
Как установить qemu-mcp в Claude Code?
Выполни claude mcp add qemu-mcp -- uvx qemu-mcp. Для запуска также нужен QEMU.
Что делает qemu-mcp?
Запускает виртуальные машины QEMU и позволяет агенту нажимать клавиши, вводить текст, снимать экран и работать с последовательной консолью. Гостевой агент и сеть для управления не требуются.
Что нужно для работы qemu-mcp?
Нужны QEMU и uvx. Для сохранения снимков состояния требуется диск в формате qcow2.