Desktop · stdio · local
Mouse Driver
Human-shaped pointer control for this desktop.
Connected
stdio
1.0.0
9 tools
What it does
Drives the real X11 pointer on trinity the way a hand would: curved approach, variable speed, overshoot correction, tremor, deliberate pauses. Armed per session, with a kill switch and a live HUD.
Touch the machine itself: pointer, windows, input. Local stdio only, never exposed.
Tools
| Tool | Description |
|---|---|
| mouse_arm | Arm pointer control for a bounded session and return the expiry. Every action tool refuses to move the pointer while disarmed. |
| mouse_disarm | Disarm immediately and stop any motion in flight. Equivalent to the Esc double-press kill switch. |
| mouse_status | Armed state, remaining TTL, cursor position, screen geometry and the current session counters. |
| mouse_move | Move to a screen coordinate with human motion: curved approach, speed profile, overshoot correction and tremor. Returns the path actually taken. |
| mouse_click | Move to the target, settle, then click. Button and click count are explicit; the settle delay prevents drags being read as clicks. |
| mouse_drag | Press, move along a curve with deliberate speed, then release. Used for selection and scrollbar drags. |
| mouse_scroll | Scroll by a number of notches at the current pointer, with the same easing as movement. |
| mouse_trace | Return the recorded path of the last action, downsampled, for verification and the HUD trail. |
| mouse_session | Start, inspect or end a named session. Sessions carry the telemetry record the console replays. |
Documented from the v1.0.0 contract. The running server's tools/list is authoritative.
Install / connect
~/projects/mouse-driver-kituwa/.venv/bin/python -m mouse_driver.mcp_server
Client-side configuration. Secrets and connection strings belong in your own environment, never in this registry.
Safety
Refuses every pointer action unless the session is armed (mouse_arm). Esc double-press or `mouse-driver disarm` stops motion immediately. History window only.