Wayland MCP

🚀 Wayland MCP Server

Note: This project was created because existing screenshot solutions did not work reliably in my Wayland setup. Wayland MCP provides tools for screenshot capture, analysis, mouse, and keyboard control in modern Linux desktop environments.

🚀 Quick Start

🔧 Input Simulation Setup

./setup.sh

View setup.sh on GitHub

Configure permissions to allow evemu-event to control input devices.

⚙️ MCP Server Configuration

Add the following to your MCP server configuration file (.roo/mcp.json):

{
  "mcpServers": {
    "wayland-screenshot": {
      "command": "uvx",
      "args": ["wayland-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key",
        "VLM_MODEL": "qwen/qwen2.5-vl-72b-instruct:free",
        "XDG_RUNTIME_DIR": "/run/user/1000",
        "WAYLAND_MCP_PORT": "4999",
        "DISPLAY": ":0",
        "WAYLAND_DISPLAY": "wayland-0",
        "XDG_SESSION_TYPE": "wayland"
      }
    }
  }
}

✨ Features

• 📸 Screenshot and Analysis

  • Custom VLM integration for image analysis
  • Image comparison functionality

• 🖱️ Input Simulation

  • Mouse control (movement, click, drag, scroll)
  • Keyboard input (typing, key presses)
  • Action chains for complex sequence operations

⚠️ Security Warning

Warning: Enabling input control gives the MCP server full access to the mouse and keyboard. Only enable it on trusted MCP servers and models.

🛠️ Development

git clone https://github.com/someaka/wayland-mcp
cd wayland-mcp
pip install -e .

📄 License

GPL 3