KWin

Acerca de

KWin provides a robust Model Context Protocol (MCP) server designed for comprehensive Linux desktop GUI automation on KDE Plasma 6 Wayland. It empowers AI agents, such as Claude Code, to seamlessly interact with and observe any Wayland application within fully isolated virtual KWin sessions, ensuring the user's desktop remains unaffected. With a rich set of 29 MCP tools covering mouse, keyboard, touch, accessibility inspection, screenshot capture, and window management, it offers a complete solution for end-to-end GUI testing and advanced desktop automation on Linux environments.

Características Principales

• Bypasses XDG RemoteDesktop portal with KWin's private EIS D-Bus interface, enabling input injection without authorization prompts.
• Offers full input coverage including mouse, keyboard, multi-touch, and clipboard, all injected within the isolated session.
• Utilizes the AT-SPI2 accessibility tree for structured UI interaction, reducing reliance on visual recognition for AI agents.
• Supports interaction with any Wayland application (Qt, GTK, Electron, etc.) through the standard `libei` protocol.
• Runs each session in its own `dbus-run-session` + `kwin_wayland --virtual` sandbox, ensuring isolation from the host desktop.
• 0 GitHub stars

Casos de Uso

• AI-driven desktop automation, allowing AI agents like Claude Code to autonomously operate desktop applications.
• Automated GUI testing for KDE/Qt/GTK applications in headless isolated sessions, verifying results via screenshots and accessibility tree.
• Headless GUI testing in CI/CD pipelines, enabling integration into environments without physical displays like GitHub Actions.