mcpField
🚀
🚀 Wayland MCP Server

🚀 Wayland MCP Server

本地服务
github.com/someaka其他1757 周前更新
代码仓库

关于 🚀 Wayland MCP Server

Wayland MCP Server 为 Wayland 桌面提供截图、图像分析和输入控制工具，适用于需要操作 Linux 桌面的 Agent。它支持自定义 VLM 分析、图像比较，以及鼠标键盘操作和动作串联。

主要功能

  1. 01Wayland 桌面截图
  2. 02自定义 VLM 图像分析
  3. 03图像比较
  4. 04鼠标与键盘控制
  5. 05串联输入操作

适用场景

  1. 01截取并分析桌面画面
  2. 02比较不同状态的屏幕图像
  3. 03执行鼠标键盘交互序列

MCP 相关

该 MCP 服务向 MCP 客户端提供 Wayland 桌面的截图、图像分析、鼠标和键盘控制工具。启用输入控制后，服务可完全访问鼠标和键盘。

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

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "wayland": {
      "command": "uvx",
      "args": [
        "wayland-mcp"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "VLM_MODEL": "<VLM_MODEL>",
        "XDG_RUNTIME_DIR": "<XDG_RUNTIME_DIR>",
        "WAYLAND_MCP_PORT": "<WAYLAND_MCP_PORT>",
        "DISPLAY": "<DISPLAY>",
        "WAYLAND_DISPLAY": "<WAYLAND_DISPLAY>",
        "XDG_SESSION_TYPE": "<XDG_SESSION_TYPE>"
      }
    }
  }
}
启动命令uvx wayland-mcp
需要配置的环境变量
OPENROUTER_API_KEY密钥
VLM_MODEL
XDG_RUNTIME_DIR
WAYLAND_MCP_PORT
DISPLAY
WAYLAND_DISPLAY
XDG_SESSION_TYPE

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypiwayland-mcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

🚀 Wayland MCP 服务

状态：WIP 许可证：GPL3

注意： 创建此软件包是因为现有的截图解决方案在我的 Wayland 环境中无法稳定运行。 Wayland MCP 为现代 Linux 桌面提供截图、分析、鼠标和键盘控制工具。

✨ 功能

  • 📸 截图与分析

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

  • 🖱️ 输入模拟

    • 鼠标控制（移动、点击、拖动、滚动）
    • 键盘输入（键入、按键）
    • 将操作串联起来，以执行复杂序列

⚠️ 安全警告

警告： 启用输入控制后，MCP 服务将获得对鼠标和键盘的完全访问权限。 仅与可信的 MCP 服务和模型搭配使用。

🚀 快速开始

🔧 输入控制设置
./setup.sh

在 GitHub 上查看 setup.sh

配置 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。