** AI 전체 컴퓨터 액세스 - 안전하게.** · Claude (또는 MCP 호환 LLM) 화면을보고 마우스를 이동하고 키보드에 입력하고 명령을 실행하십시오. - 격리 된 QEMU 가상 머신 내부. AI 기반 자동화, 테스트 및 컴퓨터 사용 실험을 위해 호스트 시스템을 위험없이.

SSH를 통해 QEMU 가상 기계를 제어하기위한 모델 Context Protocol (MCP) 서버. 이 서버는 마우스/키보드 컨트롤, 스크린샷, SSH 명령 실행을 통해 VM과 상호 작용할 수 있는 LLM을 지원합니다.

내용 표

• 특징
• 필수
• QEMU/libvirt 설정
• 설치
• 구성
• 사용
• 도구 참조
• 일반적인 Workflow
• LLM 자동화를 위한 모범 사례
• 건축
• 알려진 문제 및 제한
• 문제 해결

특징

-Mouse Control - 커서를 이동하고 버튼 클릭

• Keyboard 입력 - 유형 텍스트를 입력하고 키 조합을 보내
• Action Batching - 하나의 호출에서 UI 작업의 순서를 실행
• Screenshots - 캡처 및 검색 VM 스크린 샷
• **SSH 명령 실행 ** - VM에서 쉘 명령 실행
• File Transfer - 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)