MCP Marketplace
Sign inSign up
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

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

80.0K
Stars
14
Installs
6.5
Security
No ratings yet
Local

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

80.0K
Stars
15
Installs
5.3
Security
No ratings yet
Local

Toleno

Free

by Toleno · Developer Tools

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

180
Stars
694
Installs
8.0
Security
4.8
Local

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

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

-
Stars
114
Installs
10.0
Security
4.7
Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

-
Stars
85
Installs
10.0
Security
5.0
Remote

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

168.6K
Stars
82
Installs
4.2
Security
5.0
Local