KWin MCP Server

Example Use Cases

• 1

  Perform automated GUI testing of KDE/Qt/GTK applications in headless isolated sessions.

• 2

  Autonomously operate desktop applications on KDE Plasma 6 Wayland using accessibility data and input injection.

• 3

  Integrate Linux desktop GUI testing into CI/CD pipelines without requiring a physical display server.

Description

kwin-mcp provides a fully isolated virtual KWin Wayland session for launching, interacting with, and observing any Wayland application using 29 MCP tools. It supports mouse, keyboard, touch, clipboard, accessibility tree inspection, screenshot capture, and window management, enabling end-to-end GUI testing and AI-driven desktop automation without affecting the host desktop. The server uses triple isolation layers and optional home directory isolation for security and reproducibility, and requires KDE Plasma 6 on Wayland.