What this kind of tool is for
- Automate a build, test, or deployment step you repeat by hand.
- Review or refactor code in an existing repository without leaving your agent.
- Bridge an internal service or CLI into the agent toolset.
How to compare servers like this
- Scope of control:
- Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
- Environment fit:
- Match the runtime it expects (Node, Python, a container) to what you actually run.
- Maintenance signal:
- Check the last-commit date — dev tooling that lags upstream breaks first.
- Config surface:
- Prefer tools whose environment-variable or config keys are documented plainly.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the hypruse MCP server?
Computer use for Hyprland: semantic desktop state over IPC, plus vision and native input
How to install hypruse
Copy-paste configuration for popular MCP clients.
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_CONFINERestrict 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.
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.
{
"mcpServers": {
"hypruse": {
"command": "uvx",
"args": [
"hypruse"
],
"env": {
"HYPRUSE_SCREENSHOT_MODE": "<YOUR_HYPRUSE_SCREENSHOT_MODE>",
"HYPRUSE_READONLY": "<YOUR_HYPRUSE_READONLY>",
"HYPRUSE_CONFINE": "<YOUR_HYPRUSE_CONFINE>",
"HYPRUSE_AUTH_GUARD": "<YOUR_HYPRUSE_AUTH_GUARD>",
"HYPRUSE_STRICT": "<YOUR_HYPRUSE_STRICT>",
"HYPRUSE_MARK": "<YOUR_HYPRUSE_MARK>",
"HYPRUSE_CLIPBOARD": "<YOUR_HYPRUSE_CLIPBOARD>",
"HYPRUSE_JOURNAL": "<YOUR_HYPRUSE_JOURNAL>",
"HYPRUSE_JOURNAL_MAX_BYTES": "<YOUR_HYPRUSE_JOURNAL_MAX_BYTES>",
"HYPRUSE_JOURNAL_TEXT": "<YOUR_HYPRUSE_JOURNAL_TEXT>",
"HYPRUSE_DRYRUN": "<YOUR_HYPRUSE_DRYRUN>"
}
}
}
}Related MCP servers
Inspect and score any MCP server 0-100 on publishability, schema and protocol before publish.

io.github.IndigoProtocol/cardano-mcp
Cardano MCP — transactions, addresses, UTxOs, balances, ADAHandles & stake delegation
Elixium AI — XP-native agile platform. TDD-gated stories, team decisions, learning loop.
An AI-powered, safe database access gateway built on the Model Context Protocol (MCP).

hybridlog
Reads your own Garmin mirror: readiness, training load, muscle freshness, and read-only SQL.

