shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

wayland-mcp

Wayland MCP是一个为现代Linux桌面提供截图分析及输入控制工具的服务项目，解决现有方案在Wayland环境下的可靠性问题。

article

README

🚀 Wayland MCP 服务器

Wayland MCP 服务器专为现代 Linux 桌面环境打造，因现有截图方案在 Wayland 设置中不可靠而创建。它提供了截图、分析以及鼠标和键盘控制等实用工具。

状态: 进行中 许可证: GPL3

⚠️ 重要提示

该项目创建是因为现有的截图解决方案在我的 Wayland 设置中无法可靠工作。Wayland MCP 提供了截图、分析、鼠标和键盘控制工具，适用于现代 Linux 桌面环境。

✨ 主要特性

  • 📸 截图与分析

    • 定制的 VLM 集成用于图像分析
    • 图像比较功能

  • 🖱️ 输入模拟

    • 鼠标控制（移动、点击、拖动、滚动）
    • 键盘输入（打字、按键）
    • 动作链，支持复杂序列操作

⚠️ 安全警告

⚠️ 重要提示

启用输入控制会赋予 MCP 服务器完全的鼠标和键盘访问权限。仅在受信任的 MCP 服务器和模型上启用。

🚀 快速开始

🔧 输入模拟设置

./setup.sh

查看 setup.sh 在 GitHub 上

配置权限以允许 evemu-event 控制输入设备。

⚙️ MCP 服务器配置

添加到你的 MCP 服务器配置文件（.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"
      }
    }
  }
}

📦 安装指南

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

📄 许可证

GPL 3

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client