Hyprland Computer Use — MCP-сервер для Claude Code
Даёт агенту возможность управлять рабочим столом в Hyprland на Wayland через снимки экрана, ввод по uinput и дерево окон hyprctl.
claude mcp add hypr-cua-mcp -- uvx hypr-cua-mcpЧто делает Hyprland Computer Use
MCP-сервер связывает языковую модель с окружением Hyprland через стандартный ввод-вывод. Вместо слепых кликов по гигантскому холсту нескольких мониторов инструмент делает снимки конкретного экрана или окна утилитой grim, уменьшает их под лимиты токенов и возвращает идентификатор кадра. Координаты из ответа модели сервер сам пересчитывает в глобальные пиксели рабочего стола.
Нажатия клавиш и перемещения курсора эмулируются через системное устройство /dev/uinput. Серверу нужны права на чтение и запись этого файла. Список окон считывается напрямую через hyprctl, где адреса окон передаются в шестнадцатеричном виде. Для вызова диспетчера окон и смены фокуса понадобится Hyprland 0.55+ с конфигурацией на Lua, а фоновые задачи можно запускать без перехвата фокуса через изолированный сокет tmux или протокол CDP.
Какие задачи решает
- управлять окнами и кликать по интерфейсу в сессии Wayland
- делать прицельные скриншоты отдельных окон без захвата соседних мониторов
- передавать текст и горячие клавиши в активные программы через
uinput - выполнять фоновые консольные команды в изолированных сессиях
tmux
Примеры запросов агенту
- Сделай скриншот активного монитора и нажми на кнопку сохранения в окне редактора
- Найди окно браузера через hyprctl и переключи на него фокус
- Прочитай содержимое буфера обмена Wayland и вставь его в фоновую задачу tmux
Как установить Hyprland Computer Use
Командой платформы
claude mcp add hypr-cua-mcp -- uvx hypr-cua-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from hypr-cua-mcp <команда>
Командой платформы
codex mcp add hyprland-computer-use -- uvx hypr-cua-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from hypr-cua-mcp <команда>
Файл настроек
{
"mcpServers": {
"hyprland-computer-use": {
"command": "uvx",
"args": [
"hypr-cua-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from hypr-cua-mcp <команда>
Файл настроек
{
"servers": {
"hyprland-computer-use": {
"type": "stdio",
"command": "uvx",
"args": [
"hypr-cua-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from hypr-cua-mcp <команда>
Командой платформы
gemini mcp add hyprland-computer-use uvx hypr-cua-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from hypr-cua-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hyprland Computer Use
Как установить Hyprland Computer Use в Claude Code?
Выполните в терминале команду claude mcp add hyprland-computer-use -- uvx hypr-cua-mcp. Запускать клиент нужно внутри активной сессии Hyprland.
Что делает Hyprland Computer Use?
Сервер даёт ИИ-агентам доступ к управлению рабочим столом: чтение дерева окон через hyprctl, снимки экрана через grim и симуляция ввода мыши и клавиатуры через /dev/uinput.
Какие системные зависимости нужны для запуска?
В системе должны быть установлены Hyprland, Python 3.11+, пакетный менеджер uv, утилиты grim и wl-clipboard, а у пользователя должен быть доступ к устройству /dev/uinput.
