Wayland MCP
W

Wayland MCP

Wayland MCP is a service project that provides screenshot analysis and input control tools for modern Linux desktops, solving the reliability problem of existing solutions in the Wayland environment.
2 points
10.2K

What is Wayland MCP Server?

Wayland MCP Server is a tool designed specifically for modern Linux desktop environments, providing screenshot capture, image analysis, and mouse and keyboard simulation control functions. It solves the instability problem of traditional screenshot tools in the Wayland environment.

How to use Wayland MCP Server?

After simple command-line installation and configuration, you can integrate it into the MCP server and control the desktop environment and obtain screen information through API calls.

Applicable scenarios

Suitable for scenarios such as automated testing, remote control, and intelligent desktop assistants, especially modern Linux desktop environments based on Wayland, such as GNOME/KDE.

Main features

Screenshot and analysis
Supports high-quality screen screenshots, integrates the VLM model for image content analysis, and provides an image comparison function
Input simulation
Complete mouse and keyboard control capabilities, including movement, clicking, dragging, scrolling, and keyboard input
Action chain
Supports combining multiple input actions to form complex operation sequences
Advantages
Optimized specifically for the Wayland environment, solving the compatibility problem of traditional tools
Provides complete input control capabilities, supporting complex automated operations
Integrates AI image analysis functions, expanding application scenarios
Limitations
Only supports the Wayland environment and is not applicable to X11
The input control function has security risks and needs to be used with caution
Requires permission configuration, and the initial setup is relatively complex

How to use

Installation preparation
Ensure that the system uses the Wayland desktop environment and install the necessary dependencies
Set permissions
Run the setup.sh script to configure input device permissions
Integration configuration
Add the Wayland MCP service configuration to the MCP server configuration file

Usage examples

Automated testing
Automatically open an application and verify interface elements
Intelligent assistant
Provide operation suggestions based on the screen content

Frequently Asked Questions

Why do I need to run setup.sh?
How to ensure safe use?
Which Wayland desktop environments are supported?

Related resources

GitHub repository
Project source code and latest version
Wayland protocol documentation
Official Wayland documentation
MCP server guide
MCP server integration guide

Installation

Copy the following command to your Client for configuration
{
  "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"
      }
    }
  }
}
Note: Your key is sensitive information, do not share it with anyone.

Alternatives

V
Vestige
Vestige is an AI memory engine based on cognitive science. By implementing 29 neuroscience modules such as prediction error gating, FSRS - 6 spaced repetition, and memory dreaming, it provides long - term memory capabilities for AI. It includes a 3D visualization dashboard and 21 MCP tools, runs completely locally, and does not require the cloud.
Rust
9.6K
4.5 points
M
Moltbrain
MoltBrain is a long-term memory layer plugin designed for OpenClaw, MoltBook, and Claude Code, capable of automatically learning and recalling project context, providing intelligent search, observation recording, analysis statistics, and persistent storage functions.
TypeScript
10.2K
4.5 points
B
Bm.md
A feature-rich Markdown typesetting tool that supports multiple style themes and platform adaptation, providing real-time editing preview, image export, and API integration capabilities
TypeScript
14.9K
5 points
S
Security Detections MCP
Security Detections MCP is a server based on the Model Context Protocol that allows LLMs to query a unified security detection rule database covering Sigma, Splunk ESCU, Elastic, and KQL formats. The latest version 3.0 is upgraded to an autonomous detection engineering platform that can automatically extract TTPs from threat intelligence, analyze coverage gaps, generate SIEM-native format detection rules, run tests, and verify. The project includes over 71 tools, 11 pre-built workflow prompts, and a knowledge graph system, supporting multiple SIEM platforms.
TypeScript
6.7K
4 points
P
Paperbanana
Python
10.0K
5 points
B
Better Icons
An MCP server and CLI tool that provides search and retrieval of over 200,000 icons, supports more than 150 icon libraries, and helps AI assistants and developers quickly obtain and use icons.
TypeScript
8.7K
4.5 points
A
Assistant Ui
assistant - ui is an open - source TypeScript/React library for quickly building production - grade AI chat interfaces, providing composable UI components, streaming responses, accessibility, etc., and supporting multiple AI backends and models.
TypeScript
10.0K
5 points
A
Apify MCP Server
The Apify MCP Server is a tool based on the Model Context Protocol (MCP) that allows AI assistants to extract data from websites such as social media, search engines, and e-commerce through thousands of ready-to-use crawlers, scrapers, and automation tools (Apify Actors). It supports OAuth and Skyfire proxy payment and can be integrated into MCP clients such as Claude and VS Code through HTTPS endpoints or local stdio.
TypeScript
8.9K
5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
28.5K
4.3 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
81.7K
4.3 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
38.2K
5 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
23.9K
4.5 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
37.5K
5 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
69.8K
4.5 points
M
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
56.5K
4.8 points
G
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
25.1K
4.5 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2026AIBase