Back to Home
kurojs icon

wayland-mcp

by kurojs

Overview

Enables AI assistants to interact with a Wayland desktop for automation, including screenshot capture, VLM analysis, mouse, and keyboard control.

Installation

Run Command
uvx wayland-mcp

Environment Variables

  • OPENROUTER_API_KEY
  • GEMINI_API_KEY
  • VLM_PROVIDER
  • VLM_MODEL
  • XDG_RUNTIME_DIR
  • WAYLAND_DISPLAY
  • WAYLAND_MCP_PORT

Security Notes

The `setup.sh` script performs highly privileged operations, including installing `evemu-tools`, setting the `setuid` bit on `evemu-event`, adding a `NOPASSWD` sudoers rule for `evemu-event`, and changing permissions on `/dev/input/event*` to `0666`. This grants the Wayland MCP server extensive and low-level control over keyboard and mouse input, which is a significant security risk if the server or a connected AI client were compromised. The README explicitly warns about this.

Similar Servers

Stats

Interest Score0
Security Score3
Cost ClassHigh
Avg Tokens1500
Stars0
Forks0
Last Update2025-11-29

Tags

WaylandDesktop AutomationAI AssistantVLMMCP