How do I install Hypruse?

Hypruse is a local plugin. Install it using PyPI package: hypruse and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Hypruse safe to use?

Hypruse was flagged by MCP Marketplace's security scan, scoring 4.2/10 (high risk). It has 5 high or critical findings to review. Review the security report on this page carefully before installing it.

What credentials does Hypruse need?

Hypruse requires the following credentials or environment variables: HYPRUSE_SCREENSHOT_MODE, HYPRUSE_READONLY, HYPRUSE_CONFINE, HYPRUSE_AUTH_GUARD, HYPRUSE_STRICT, HYPRUSE_MARK, HYPRUSE_CLIPBOARD. You can find setup instructions on the server detail page.

What AI apps work with Hypruse?

Hypruse uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Hypruse MCP Server

by IlyasKhallouki

Developer ToolsUse Caution4.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

Computer use for Hyprland: semantic desktop state over IPC, plus vision and native input

About

Computer use for Hyprland: semantic desktop state over IPC, plus vision and native input

Security Report

4.2

Use Caution4.2High Risk

hypruse is a well-designed MCP server for Hyprland desktop automation with thoughtful security layering (approval prompts, confinement, read-only mode, activity beacons). The codebase is clean and purpose-aligned. However, there are moderate security concerns: the server executes multiple external binaries (hyprctl, grim, wtype, busctl, wl-clipboard) without strict validation of their paths, environment variable handling could be more explicit, and some subprocess calls lack comprehensive error handling. The broad permissions (input injection, screenshot capture, file I/O) are justified by the server's stated purpose but require user awareness and proper sandboxing at the MCP client level. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

3 files analyzed · 13 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

clipboard

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

system_info

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

How captures are returned: 'file' writes to XDG_RUNTIME_DIR and returns the path, 'image' returns the image inline. Use 'image' for clients that render MCP images but cannot read files, such as Claude Desktop.Optional

Environment variable: HYPRUSE_SCREENSHOT_MODE

Set to 1 to expose only the observation tools (desktop, screenshot, zoom, ui, marks, binds, wait_for). The agent can see and narrate but cannot click, type, or launch.Optional

Environment variable: HYPRUSE_READONLY

Restrict input to a scope of windows and refuse everything outside it: 'launched' (only windows hypruse opened this session), 'class:firefox,kitty', or 'workspace:3,special:notes'. Unset means no confinement.Optional

Environment variable: HYPRUSE_CONFINE

Refuse to click or type into system authentication dialogs (polkit, keyring prompts). On by default; 'strict' also refuses password fields in ordinary windows; 0 disables it.Optional

Environment variable: HYPRUSE_AUTH_GUARD

Set to 1 to refuse to act when the cursor or focused window moved since hypruse's last action, so the agent must re-read the desktop before retrying.Optional

Environment variable: HYPRUSE_STRICT

Set to 1 to make the agent's presence legible: tag every window it opens 'hypruse-owned' and flash an on-screen notice when it opens a window or captures the screen.Optional

Environment variable: HYPRUSE_MARK

Set to 1 to register the opt-in clipboard tool (never in read-only mode). Off by default because clipboards hold passwords.Optional

Environment variable: HYPRUSE_CLIPBOARD

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-ilyaskhallouki-hypruse": {
      "env": {
        "HYPRUSE_MARK": "your-hypruse-mark-here",
        "HYPRUSE_STRICT": "your-hypruse-strict-here",
        "HYPRUSE_CONFINE": "your-hypruse-confine-here",
        "HYPRUSE_READONLY": "your-hypruse-readonly-here",
        "HYPRUSE_CLIPBOARD": "your-hypruse-clipboard-here",
        "HYPRUSE_AUTH_GUARD": "your-hypruse-auth-guard-here",
        "HYPRUSE_SCREENSHOT_MODE": "your-hypruse-screenshot-mode-here"
      },
      "args": [
        "hypruse"
      ],
      "command": "uvx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Hypruse MCP Server

About

Security Report

Findings (13)Action required

Permissions Required

What You'll Need

How to Install

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace

FinAgent