🚀 Wayland MCP Server
@someaka
About 🚀 Wayland MCP Server
MCP Server for Wayland
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"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
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
FAQ from Wayland MCP Server
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.
How do I set up input control?
Run ./setup.sh to configure permissions for evemu-event to control input devices.
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.
What dependencies are required?
The server runs via uvx and requires evemu-event for input simulation. It is developed on modern Linux with Wayland.
How is this server licensed?
It is licensed under the GPL3 open‑source license.
Frequently asked questions
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.
How do I set up input control?
Run `./setup.sh` to configure permissions for `evemu-event` to control input devices.
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.
What dependencies are required?
The server runs via `uvx` and requires `evemu-event` for input simulation. It is developed on modern Linux with Wayland.
How is this server licensed?
It is licensed under the GPL3 open‑source license.
Basic information
More Other MCP servers
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
Comments