Qt Pilot Usage

Qt Pilot is a bundled MCP server that lets Claude launch, interact with, and visually test PySide6 Qt applications — without a physical display. It uses Xvfb (X Virtual Framebuffer) for headless rendering and communicates with a test harness over a Unix socket.

Use /qt:visual to start a visual testing session.

Architecture

Claude (MCP tools)
       ↓
Qt Pilot MCP server (mcp/qt-pilot/main.py)
       ↓  (Unix socket)
Qt Pilot Harness (runs inside Xvfb)
       ↓
Target Qt/PySide6 Application

The harness launches inside the virtual display, imports the application, and exposes widget interactions back to the MCP server.