Search / io.github.IlyasKhallouki/hypruse
protogridL0· runs locallyComputer use for Hyprland: semantic desktop state over IPC, plus vision and native input
v0.13.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"hypruse": {
"command": "uvx",
"args": [
"hypruse==0.13.0"
],
"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"
}
}
}
}claude mcp add hypruse -e "HYPRUSE_SCREENSHOT_MODE=file" -e "HYPRUSE_READONLY=0" -e "HYPRUSE_AUTH_GUARD=1" -e "HYPRUSE_STRICT=0" -e "HYPRUSE_MARK=0" -e "HYPRUSE_CLIPBOARD=0" -e "HYPRUSE_JOURNAL=0" -e "HYPRUSE_JOURNAL_MAX_BYTES=8388608" -e "HYPRUSE_JOURNAL_TEXT=0" -e "HYPRUSE_DRYRUN=0" -- uvx hypruse==0.13.0[mcp_servers.hypruse]
command = "uvx"
args = ["hypruse==0.13.0"]
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" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"hypruse": {
"type": "local",
"command": [
"uvx",
"hypruse==0.13.0"
],
"enabled": true,
"environment": {
"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"
}
}
}
}{
"mcpServers": {
"hypruse": {
"command": "uvx",
"args": [
"hypruse==0.13.0"
],
"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"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=hypruse&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJoeXBydXNlPT0wLjEzLjAiXSwiZW52Ijp7IkhZUFJVU0VfU0NSRUVOU0hPVF9NT0RFIjoiZmlsZSIsIkhZUFJVU0VfUkVBRE9OTFkiOiIwIiwiSFlQUlVTRV9BVVRIX0dVQVJEIjoiMSIsIkhZUFJVU0VfU1RSSUNUIjoiMCIsIkhZUFJVU0VfTUFSSyI6IjAiLCJIWVBSVVNFX0NMSVBCT0FSRCI6IjAiLCJIWVBSVVNFX0pPVVJOQUwiOiIwIiwiSFlQUlVTRV9KT1VSTkFMX01BWF9CWVRFUyI6IjgzODg2MDgiLCJIWVBSVVNFX0pPVVJOQUxfVEVYVCI6IjAiLCJIWVBSVVNFX0RSWVJVTiI6IjAifX0%3D"
}{
"servers": {
"hypruse": {
"type": "stdio",
"command": "uvx",
"args": [
"hypruse==0.13.0"
],
"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"
}
}
}
}{
"mcpServers": {
"hypruse": {
"command": "uvx",
"args": [
"hypruse==0.13.0"
],
"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"
}
}
}
}extensions:
"hypruse":
enabled: true
name: "hypruse"
type: stdio
cmd: "uvx"
args:
- "hypruse==0.13.0"
envs:
"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"
timeout: 300
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknownNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-2d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] PyPIthis version is not known to the dependency resolver
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
hypruse | pypi | 0.13.0 | uvx |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.IlyasKhallouki/hypruse",
"title": "hypruse",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.13.0",
"packages": [
{
"version": "0.13.0",
"transport": {
"type": "stdio"
},
"identifier": "hypruse",
"runtimeHint": "uvx",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "HYPRUSE_SCREENSHOT_MODE",
"choices": [
"file",
"image"
],
"default": "file",
"description": "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."
},
{
"name": "HYPRUSE_READONLY",
"default": "0",
"description": "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."
},
{
"name": "HYPRUSE_CONFINE",
"description": "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.",
"placeholder": "launched"
},
{
"name": "HYPRUSE_AUTH_GUARD",
"choices": [
"1",
"strict",
"0"
],
"default": "1",
"description": "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."
},
{
"name": "HYPRUSE_STRICT",
"default": "0",
"description": "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."
},
{
"name": "HYPRUSE_MARK",
"default": "0",
"description": "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."
},
{
"name": "HYPRUSE_CLIPBOARD",
"default": "0",
"description": "Set to 1 to register the opt-in clipboard tool (never in read-only mode). Off by default because clipboards hold passwords."
},
{
"name": "HYPRUSE_JOURNAL",
"default": "0",
"description": "Record 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."
},
{
"name": "HYPRUSE_JOURNAL_MAX_BYTES",
"default": "8388608",
"description": "Rotate the journal once it reaches this size, keeping one previous generation alongside it. Set 0 to never rotate."
},
{
"name": "HYPRUSE_JOURNAL_TEXT",
"default": "0",
"description": "Set 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."
},
{
"name": "HYPRUSE_DRYRUN",
"default": "0",
"description": "Set 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."
}
]
}
],
"repository": {
"id": "1302513522",
"url": "https://github.com/IlyasKhallouki/hypruse",
"source": "github"
},
"websiteUrl": "https://github.com/IlyasKhallouki/hypruse#readme",
"description": "Computer use for Hyprland: semantic desktop state over IPC, plus vision and native input"
}