🚀 Wayland MCP Server

Name: 🚀 Wayland MCP Server
Author: someaka

@someaka

代码仓库

关于 🚀 Wayland MCP Server

MCP Server for Wayland

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

基本信息

分类

其他

运行时

python

传输方式

stdio

发布者

someaka

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.