Wayland MCP

🚀 Wayland MCP 服務器

Wayland MCP 服務器專為現代 Linux 桌面環境打造，因現有截圖方案在 Wayland 設置中不可靠而創建。它提供了截圖、分析以及鼠標和鍵盤控制等實用工具。

⚠️ 重要提示

該項目創建是因為現有的截圖解決方案在我的 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