hypruse

io.github.IlyasKhallouki/hypruse

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

View repository →Homepage →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "hypruse": {
      "command": "uvx",
      "args": [
        "hypruse"
      ],
      "env": {
        "HYPRUSE_SCREENSHOT_MODE": "file",
        "HYPRUSE_READONLY": "0",
        "HYPRUSE_AUTH_GUARD": "1",
        "HYPRUSE_STRICT": "0",
        "HYPRUSE_MARK": "0",
        "HYPRUSE_CLIPBOARD": "0",
        "HYPRUSE_JOURNAL": "0",
        "HYPRUSE_JOURNAL_MAX_BYTES": "8388608",
        "HYPRUSE_JOURNAL_TEXT": "0",
        "HYPRUSE_DRYRUN": "0"
      }
    }
  }
}
Environment variables
  • HYPRUSE_SCREENSHOT_MODEHow 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.
  • HYPRUSE_READONLYSet 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.
  • HYPRUSE_AUTH_GUARDRefuse 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.
  • HYPRUSE_STRICTSet 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.
  • HYPRUSE_MARKSet 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.
  • HYPRUSE_CLIPBOARDSet to 1 to register the opt-in clipboard tool (never in read-only mode). Off by default because clipboards hold passwords.
  • HYPRUSE_JOURNALRecord every tool call, refusals included, as one NDJSON line: 1 writes to XDG_STATE_HOME/hypruse/journal.ndjson, or give a path. Read it back with 'hypruse journal'. Off by default.
  • HYPRUSE_JOURNAL_MAX_BYTESRotate the journal once it reaches this size, keeping one previous generation alongside it. Set 0 to never rotate.
  • HYPRUSE_JOURNAL_TEXTSet to 1 to record typed and copied text in the journal verbatim instead of as a length plus digest. Off by default because keystrokes are passwords; needed only to replay typing.
  • HYPRUSE_DRYRUNSet to 1 for a rehearsal: every acting tool validates its arguments and runs every trust guard, then reports what it would have done and delivers no input.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.13.0
Registry
active
Published
10/18/2026

More Developer Tools servers

Browse all Developer Tools →

Авито MCP (RU)

ilyautov

API Авито в ИИ-ассистенте: объявления, чаты, заказы, автозагрузка, отзывы

Developer ToolsAdded 1 month ago

Честный знак MCP (RU) — коды маркировки, ГИС МТ, СУЗ

ilyautov

API Честного знака в ИИ-ассистенте: коды маркировки, эмиссия в СУЗ, отчёты

Developer ToolsAdded 1 month ago

Consilium Principis

ilyautov

AI advisory board (MCP): quotes verified word-for-word against public-domain texts, fail-closed

Developer ToolsAdded 3 months ago

Диадок MCP (RU) — ЭДО, документы, контрагенты

ilyautov

API Диадока в ИИ-ассистенте: документы ЭДО, контрагенты, подписание, МЧД

Developer ToolsAdded 1 month ago

humanizer-ru

ilyautov

Следы нейросети в русском тексте: балл чистоты 0-100, запреты и маркеры с позициями, факт-замок.

Developer ToolsAdded 3 weeks ago

inn-check-ru

ilyautov

Проверка контрагента РФ по ИНН: светофор риска по реестрам, финансы и санкции кодом.

Developer ToolsAdded 1 month ago

Add the badge to your site

Show visitors that hypruse is listed here — it’s also the link we check for a free listing.

hypruse — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-ilyaskhallouki-hypruse?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="hypruse — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![hypruse — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-ilyaskhallouki-hypruse?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.