# 安装 hypruse

- 类型: MCP 工具
- 说明: Computer use for Hyprland: semantic desktop state over IPC, plus vision and native input
- 仓库: https://github.com/IlyasKhallouki/hypruse

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "hypruse" MCP 服务：
执行：claude mcp add 'io-github-ilyaskhallouki-hypruse' -- uvx hypruse
```

### Codex
```
请帮我安装 askskill 上的 "hypruse" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-ilyaskhallouki-hypruse]
command = "uvx"
args = ["hypruse"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "hypruse" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-ilyaskhallouki-hypruse": { "command": "uvx", "args": ["hypruse"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env HYPRUSE_SCREENSHOT_MODE=YOUR_VALUE --env HYPRUSE_READONLY=YOUR_VALUE --env HYPRUSE_CONFINE=YOUR_VALUE --env HYPRUSE_AUTH_GUARD=YOUR_VALUE --env HYPRUSE_STRICT=YOUR_VALUE --env HYPRUSE_MARK=YOUR_VALUE --env HYPRUSE_CLIPBOARD=YOUR_VALUE --transport stdio io-github-ilyaskhallouki-hypruse -- uvx hypruse
```
需要环境变量：HYPRUSE_SCREENSHOT_MODE, HYPRUSE_READONLY, HYPRUSE_CONFINE, HYPRUSE_AUTH_GUARD, HYPRUSE_STRICT, HYPRUSE_MARK, HYPRUSE_CLIPBOARD

### Codex
```bash
codex mcp add --env HYPRUSE_SCREENSHOT_MODE=YOUR_VALUE --env HYPRUSE_READONLY=YOUR_VALUE --env HYPRUSE_CONFINE=YOUR_VALUE --env HYPRUSE_AUTH_GUARD=YOUR_VALUE --env HYPRUSE_STRICT=YOUR_VALUE --env HYPRUSE_MARK=YOUR_VALUE --env HYPRUSE_CLIPBOARD=YOUR_VALUE io-github-ilyaskhallouki-hypruse -- uvx hypruse
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-ilyaskhallouki-hypruse]
command = "uvx"
args = ["hypruse"]

[mcp_servers.io-github-ilyaskhallouki-hypruse.env]
HYPRUSE_SCREENSHOT_MODE = "YOUR_VALUE"
HYPRUSE_READONLY = "YOUR_VALUE"
HYPRUSE_CONFINE = "YOUR_VALUE"
HYPRUSE_AUTH_GUARD = "YOUR_VALUE"
HYPRUSE_STRICT = "YOUR_VALUE"
HYPRUSE_MARK = "YOUR_VALUE"
HYPRUSE_CLIPBOARD = "YOUR_VALUE"
```
需要环境变量：HYPRUSE_SCREENSHOT_MODE, HYPRUSE_READONLY, HYPRUSE_CONFINE, HYPRUSE_AUTH_GUARD, HYPRUSE_STRICT, HYPRUSE_MARK, HYPRUSE_CLIPBOARD

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-ilyaskhallouki-hypruse": {
      "command": "uvx",
      "args": [
        "hypruse"
      ],
      "env": {
        "HYPRUSE_SCREENSHOT_MODE": "YOUR_VALUE",
        "HYPRUSE_READONLY": "YOUR_VALUE",
        "HYPRUSE_CONFINE": "YOUR_VALUE",
        "HYPRUSE_AUTH_GUARD": "YOUR_VALUE",
        "HYPRUSE_STRICT": "YOUR_VALUE",
        "HYPRUSE_MARK": "YOUR_VALUE",
        "HYPRUSE_CLIPBOARD": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-ilyaskhallouki-hypruse&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJoeXBydXNlIl0sImVudiI6eyJIWVBSVVNFX1NDUkVFTlNIT1RfTU9ERSI6IllPVVJfVkFMVUUiLCJIWVBSVVNFX1JFQURPTkxZIjoiWU9VUl9WQUxVRSIsIkhZUFJVU0VfQ09ORklORSI6IllPVVJfVkFMVUUiLCJIWVBSVVNFX0FVVEhfR1VBUkQiOiJZT1VSX1ZBTFVFIiwiSFlQUlVTRV9TVFJJQ1QiOiJZT1VSX1ZBTFVFIiwiSFlQUlVTRV9NQVJLIjoiWU9VUl9WQUxVRSIsIkhZUFJVU0VfQ0xJUEJPQVJEIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：HYPRUSE_SCREENSHOT_MODE, HYPRUSE_READONLY, HYPRUSE_CONFINE, HYPRUSE_AUTH_GUARD, HYPRUSE_STRICT, HYPRUSE_MARK, HYPRUSE_CLIPBOARD