Skip to content

Releases

v0.2.0

Choose a tag to compare

@ryanportfolio ryanportfolio released this 01 Oct 22:59
f7553ab

winuse-mcp now uses the tool and argument names of Anthropic's computer use toolset, computer_toolset_20260801, and adds the four actions it was missing.

Breaking: argument names changed

Every tool that takes a position now uses Anthropic's argument names. Clients that read the tool schemas at startup, which includes Claude Code, pick this up on their own. Scripts that call the tools by argument name need updating:

Tool v0.1.x v0.2.0
left_click, double_click, triple_click, right_click, middle_click, mouse_move x, y coordinate: [x, y]
left_click_drag start_x, start_y, end_x, end_y start_coordinate, coordinate
scroll x, y, direction, amount scroll_direction, scroll_amount, coordinate
key combo text
wait seconds duration
cursor_position result (x, y) X=x, Y=y

Added

  • zoom(region): captures [x0, y0, x1, y1] at full resolution for text too small to read in a screenshot.
  • hold_key(text, duration): holds a key or chord for up to 10s. Parking the mouse at the top-left pixel releases it early. A shifted character is named by its base key: shift+=, not +.
  • left_mouse_down() and left_mouse_up(): press and release at the cursor, for drags left_click_drag cannot express.
  • text on clicks, drags and scrolls: modifier keys held for that one action, such as shift or ctrl+shift.
  • coordinate is optional on clicks and scrolls; leaving it out acts at the cursor.
  • key takes repeat, 1 to 100.

Differences from Anthropic's toolset

record is extra. wait and hold_key stop at 10s where Anthropic allows 300s, and scroll_amount stops at 20. Only the primary monitor is captured; the current toolset has no monitor selection either.

Also in this release

  • The README points Claude Desktop users on Windows to the built-in computer use feature, and lists where winuse fits: the Claude Code CLI on Windows, plans and providers the built-in feature excludes, and other MCP clients.
  • Headless pytest unit tests, run in CI, with mss, pyautogui and pyperclip stubbed.
  • pyproject.toml version is 0.2.0. It said 0.1.0 through v0.1.1.

Install

claude mcp add --scope user winuse -- uvx --from git+https://github.com/ryanportfolio/winuse-mcp@v0.2.0 winuse-mcp