** Дайте вашему ИИ полный доступ к компьютеру — безопасно.

Позвольте Клоду (или любому MCP-совместимому LLM) видеть ваш экран, перемещать мышь, вводить на клавиатуре и запускать команды — все это внутри изолированной виртуальной машины QEMU. Идеально подходит для автоматизации, тестирования и компьютерных экспериментов без риска для вашей хост-системы.

Сервер Model Context Protocol (MCP) для управления виртуальными машинами QEMU через SSH. Этот сервер позволяет LLM взаимодействовать с виртуальными машинами через управление мышью / клавиатурой, скриншоты и выполнение команд SSH.

Таблица содержимого

• Особенности
• Предварительные условия Настройка QEMU/libvirt
• Установка
• Конфигурация
• Использование
• Ссылки на инструменты Типичный рабочий процесс Лучшие практики для автоматизации LLM
• Архитектура Известные проблемы и ограничения
• Устранение неполадок

Особенности

Управление мышью - Переместить курсор и нажать кнопки Keyboard Input - Введите текст и отправьте ключевые комбинации Action Batching - выполнение последовательностей действий пользовательского интерфейса в одном вызове Скриншоты - захват и извлечение скриншотов VM

• SSH Command Execution - Запуск команд снаряда на ВМ ** Передача файлов** - Загрузка и загрузка файлов через SFTP

MCP QEMU VM Control

Give your AI full computer access — safely.

Let Claude (or any MCP-compatible LLM) see your screen, move the mouse, type on the keyboard, and run commands — all inside an isolated QEMU virtual machine. Perfect for AI-driven automation, testing, and computer-use experiments without risking your host system.

A Model Context Protocol (MCP) server for controlling QEMU virtual machines via SSH. This server enables LLMs to interact with VMs through mouse/keyboard control, screenshots, and SSH command execution.

Table of Contents

• Features
• Prerequisites
• QEMU/libvirt Setup
• Installation
• Configuration
• Usage
• Tools Reference
• Typical Workflow
• Best Practices for LLM Automation
• Architecture
• Known Issues & Limitations
• Troubleshooting

Features

• Mouse Control - Move cursor and click buttons
• Keyboard Input - Type text and send key combinations
• Action Batching - Execute sequences of UI actions in one call
• Screenshots - Capture and retrieve VM screenshots
• SSH Command Execution - Run shell commands on the VM
• File Transfer - Upload and download files via SFTP
• Project Management - Organize outputs into project folders with logs, results, and advice
• Advice System - Save and retrieve tips for future LLM sessions

Prerequisites

Host System

• Python 3.12+
• uv (recommended) or pip
• QEMU/KVM with libvirt
• virt-manager (optional, for GUI management)

VM Requirements

• Linux with X11 desktop environment
• SSH server enabled
• Required packages: openssh, xdotool, scrot, xrandr, xinput

QEMU/libvirt Setup

1. Install virtualization packages

Arch/Manjaro:

sudo pacman -S qemu-full libvirt virt-manager dnsmasq iptables-nft

Debian/Ubuntu:

sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients virt-manager bridge-utils

Fedora:

sudo dnf install @virtualization

2. Configure libvirt

# Enable and start libvirtd
sudo systemctl enable --now libvirtd

# Add your user to libvirt group
sudo usermod -aG libvirt $USER

# Log out and back in, then verify
groups  # should show 'libvirt'

3. Set up the default network

libvirt provides a default NAT network (192.168.122.0/24) that VMs use to communicate with the host:

# Check network status
virsh -c qemu:///system net-list --all

# If 'default' is not active, start it
virsh -c qemu:///system net-start default

# Enable autostart
virsh -c qemu:///system net-autostart default

The default network configuration:

• Bridge: virbr0
• Host IP: 192.168.122.1
• DHCP range: 192.168.122.2 - 192.168.122.254
• Mode: NAT (VMs can access internet, host can access VMs)