Hypruse MCP Server - install, status & alternatives [2026]

01 · Install Hypruse

before you install - you'll need

Set HYPRUSE_SCREENSHOT_MODE before connecting.

Claude Code

claude mcp add ilyaskhallouki-hypruse -- uvx hypruse

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ilyaskhallouki-hypruse": {
      "command": "uvx",
      "args": [
        "hypruse"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-07-16 - young repo, little track record yet

license MIT - declared in the repository

pypi package hypruse - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.IlyasKhallouki is GitHub-verified and matches the repo owner

03 · What Hypruse can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can move / click / drag / scroll (discrete wheel notches) in global coordinates, start an app (optionally silent on another workspace), block on its actual openwindow event, return its address, execute a keybind by combo (SUPER+F), running its bound action, so the agent drives the owner's own launchers and shortcuts, and read or write the text clipboard via wl-clipboard.

Capability map

Tools grouped from the project's README - what Hypruse lets an agent do.

Desktop

1 tool - e.g. One-call semantic snapshot: monitors, workspaces, windows (address/class/title/geometry), active window, cursor, and layer surfaces (launchers, bars, notificati

desktop

Screenshot

1 tool - e.g. Focused monitor, exact window crop by address, or x,y,WxH region; returns image + coordinate-mapping metadata; fast JPEG by default (lossless=true for PNG); sta

screenshot

Zoom

1 tool - e.g. Native-resolution re-capture around an estimated point (optionally clamped to a window): the precision step before clicking small controls, same metadata contra

zoom

other

1 tool - e.g. Read a window's accessibility tree (AT-SPI, GTK/Qt apps that expose one) and return clickable elements by name with exact global coordinates, no screenshot; rep

ui

Marks

1 tool - e.g. Set-of-Marks capture: the window screenshot with every accessible control drawn as a numbered mark, plus a JSON legend (role, name, current value, exact click p

marks

Click

1 tool - e.g. Click a control by accessible NAME or by a marks number in one call: the coordinate comes from the tree, the click goes through the real pointer (visible, same

click_ui

Pointer

1 tool - e.g. move / click / drag / scroll (discrete wheel notches) in global coordinates

pointer

Keyboard

1 tool - e.g. Type literal text (unicode-safe) or press app-level combos (ctrl+shift+t, esc, F5); optional window address focuses the target first so keystrokes land in the r

keyboard

Latest releases

v0.9.4 · 2026-07-26

See CHANGELOG.md.

v0.9.3 · 2026-07-22

See CHANGELOG.md.

v0.9.1 · 2026-07-19

See CHANGELOG.md.

04 · Who maintains Hypruse

hypruse is maintained by ilyaskhallouki. It's the only MCP server we track from this author; the repo dates to Jul 2026.

05 · Facts

repository: github.com/ilyaskhallouki/hypruse
website: https://github.com/IlyasKhallouki/hypruse#readme
category: other - ranked #249 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 10+ releases in the last 90 days (latest 2026-07-26)
registry: io.github.IlyasKhallouki/hypruse (active, first published 2026-07-26)
packages: pypi:hypruse

06 · Hypruse FAQ

Is Hypruse still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-15 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Hypruse do?

With this server connected, an agent can move / click / drag / scroll (discrete wheel notches) in global coordinates, start an app (optionally silent on another workspace), block on its actual openwindow event, return its address, execute a keybind by combo (SUPER+F), running its bound action, so the agent drives the owner's own launchers and shortcuts, and read or write the text clipboard via wl-clipboard.

How do I install Hypruse?

Run `uvx hypruse`. The README documents one environment variable (HYPRUSE_SCREENSHOT_MODE) to set first. Set HYPRUSE_SCREENSHOT_MODE before connecting. You can also paste the ready-made client config above.

Does Hypruse run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Hypruse

Alternatives to Hypruse

Maintained other servers if Hypruse isn't the fit.

More MCP servers to compare · Consilium Principis · Aegis Protocol · Mitre Attack MCP Server · Cardano MCP · Inflow

More Python MCP servers · Marketplaces MCP (RU) - Wildberries & Ozon · Zuul · Apple Mail MCP (imdinu) · ClaudeR - RStudio MCP Server · see all