wayhand-mcp v0.1.0

TimLai666 released this 05 Sep 09:32

· 3 commits to main since this release

4aad330

First release of wayhand-mcp, a local MCP server that lets Claude Code or Codex see and operate a GNOME Wayland desktop.

Two targets: sandbox (default, headless sway; the user's mouse and keyboard stay free) and desktop (real screen via the XDG portal, real input via uinput).
Tools: screen_info, screenshot, move, click, double_click, right_click, drag, scroll, key, type, calibrate, sandbox_start, sandbox_launch, sandbox_stop.
Safety: stdio only, no shell, SIGINT and cancellation release pressed inputs, circuit breaker, single instance, root refused.

Install:

curl -fsSL https://raw.githubusercontent.com/TimLai666/wayhand-mcp/main/scripts/install.sh | bash

Asset: x86_64 Linux tarball (binary + setup scripts), depends only on libxkbcommon.

Assets 4