@agent-sh/computer-use-linux
Linux 桌面控制 MCP 服务器
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@agent-sh/computer-use-linux。 它的用途是：Linux 桌面控制 MCP 服务器 完整的 Skill 内容见：https://321skill.com/skills/agent-sh-computer-use-linux/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我打开 GNOME 终端，切换工作目录到 /home/user/project，然后执行 `ls -la` 并把输出截图给我。' 它会通过 AT-SPI 定位终端窗口，使用 Portal 模拟键盘输入，最后调用截图工具返回结果。整个操作无需手动介入，完全由 AI 代理完成。
介绍
这个 Skill 解决了在 Linux 桌面环境下，AI 代理无法直接操作本地 GUI 应用的问题。在实际开发中，开发者经常需要让 AI 自动完成点击、输入、截图等桌面操作，但 macOS 有原生 AXUIElement，而 Linux 的 Wayland 和 X11 生态碎片化，导致传统工具（如 xdotool）在 Wayland 下失效。该工具通过 AT-SPI 无障碍树、Portal 远程桌面接口和多种窗口管理器后端，让 AI 能像人类一样操控 Linux 桌面。
使用方式很简单，你只需要在任意 MCP 主机（如 Claude Desktop、Codex Desktop）中配置该服务器，或直接通过命令行运行 computer-use-linux。之后就可以通过自然语言指令来执行复杂的桌面操作，例如“打开终端并输入命令”、“截取当前窗口的截图并分析”、“点击 GNOME 设置中的 WiFi 开关”。它还内置了 doctor 命令，能一键检测系统就绪状态，返回结构化的 JSON 报告，明确告知哪些功能可用、哪些需要额外配置。
它非常适合需要为 AI 助手赋予桌面操控能力的团队或个人，尤其是那些已经使用 Claude Desktop、Hermes Agent 等 MCP 宿主，但苦于 Linux 桌面支持不足的开发者。测试工程师可以用它自动执行 GUI 测试用例；运维工程师可以用它监控远程桌面状态；智能体开发者可以将其集成到多智能体协作流程中，实现跨应用的自动化操作。
建议在 GNOME、KDE、Hyprland、i3 等主流桌面环境下使用，以获得最佳兼容性。需要注意的是，它主要依赖 AT-SPI 进行语义识别，对于纯 Canvas 或游戏等无辅助树支持的界面，会回退到像素坐标操作。Wayland 下部分功能（如窗口管理）需要安装对应的工具（如 ydotool 或 GNOME Shell 扩展），建议在首次使用前运行 computer-use-linux doctor 确认所有依赖就绪。
常见问题
支持哪些 Linux 桌面环境？
支持 GNOME、KDE/KWin、Hyprland、i3、COSMIC 等主流桌面环境，Wayland 优先，X11 尽力兼容。
需要 root 权限吗？
不需要 root 权限，但需要安装 ydotool 并启动 ydotoild 守护进程，或通过 Portal RemoteDesktop 接口获取输入权限。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-sh-computer-use-linux/raw/index.md 读取 @agent-sh/computer-use-linux 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-sh-computer-use-linux/raw/index.md（查看排版版本）