Advertise
MCP.so
Sign In

Wayland MCP Server

@someaka

Repository

Basic information

Category

Other

Transports

stdio

Author

someaka

About Wayland MCP Server

MCP Server for Wayland

#computer-vision#computer-use#computer-use-agent

Wayland MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "wayland-screenshot": {
      "command": "uvx",
      "args": [
        "wayland-mcp"
      ],
      "env": {
        "OPENROUTER_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"
      }
    }
  }
}

Wayland MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Wayland MCP Server?

Wayland MCP Server provides screenshot, analysis, mouse and keyboard control tools for modern Linux desktops running the Wayland display protocol. It is intended for users who need reliable screenshot and input simulation capabilities that existing solutions may not support under Wayland.

How to use Wayland MCP Server?

Install via uvx and add the provided JSON configuration to your MCP server config (e.g., .roo/mcp.json). Run ./setup.sh to configure permissions for input device control. Necessary environment variables include OPENROUTER_API_KEY, VLM_MODEL, XDG_RUNTIME_DIR, WAYLAND_MCP_PORT, DISPLAY, WAYLAND_DISPLAY, and XDG_SESSION_TYPE.

Key features of Wayland MCP Server

  • Screenshot capture with custom VLM integration for image analysis
  • Image comparison capabilities
  • Mouse control (move, click, drag, scroll)
  • Keyboard input (typing, key presses)
  • Action chaining for complex input sequences

Use cases of Wayland MCP Server

  • Automating desktop workflows by simulating mouse and keyboard actions
  • Taking and analyzing screenshots with vision-language model integration
  • Comparing images programmatically in a Wayland environment
  • Providing reliable input control for AI assistants on modern Linux desktops

Frequently asked questions

1

What environment variables must be set?

`OPENROUTER_API_KEY`, `VLM_MODEL`, `XDG_RUNTIME_DIR`, `WAYLAND_MCP_PORT`, `DISPLAY`, `WAYLAND_DISPLAY`, and `XDG_SESSION_TYPE` must be configured in the MCP server environment.

2

How do I set up input control?

Run `./setup.sh` to configure permissions for `evemu-event` to control input devices.

3

Is it safe to enable input control?

Enabling input control gives the MCP server full access to your mouse and keyboard. Only use with trusted MCP servers and models.

4

What dependencies are required?

The server runs via `uvx` and requires `evemu-event` for input simulation. It is developed on modern Linux with Wayland.

5

How is this server licensed?

It is licensed under the GPL3 open‑source license.

Comments

More Other MCP servers

ICSS

chokcoco

不止于 CSS

20.7K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K
Advertise