hypruse — MCP-сервер для Claude Code: управление Hyprland
Даёт ИИ-агенту доступ к состоянию рабочего стола Hyprland, снимкам экрана и управлению окнами и вводом. Пригодится для задач, которые нужно выполнить в графических приложениях.
claude mcp add --env HYPRUSE_SCREENSHOT_MODE=<HYPRUSE_SCREENSHOT_MODE> --env HYPRUSE_READONLY=<HYPRUSE_READONLY> --env HYPRUSE_CONFINE=<HYPRUSE_CONFINE> --env HYPRUSE_AUTH_GUARD=<HYPRUSE_AUTH_GUARD> --env HYPRUSE_STRICT=<HYPRUSE_STRICT> --transport stdio hypruse -- uvx hypruseЧто делает hypruse
hypruse подключает агент к рабочему столу на Hyprland через MCP. Инструмент desktop показывает окна, рабочие пространства и мониторы; screenshot и zoom помогают рассмотреть экран, а ui читает доступные элементы управления. Для переключения рабочих пространств и окон используется IPC Hyprland.
Сервер также умеет нажимать кнопки, печатать текст и запускать приложения. Ввод выполняется через Wayland; для клавиатуры используется wtype, а для снимков экрана — grim. С click_ui можно нажать элемент по имени или номеру из marks; неоднозначное имя возвращает варианты, а не выбирает наугад.
Для работы нужен Hyprland. ui зависит от того, предоставляет ли приложение дерево доступности, а для отрисовки меток marks нужен ImageMagick. Это значит, что в приложениях без дерева доступности придётся ориентироваться по изображению экрана.
Какие задачи решает
- посмотреть окна и рабочие пространства Hyprland
- найти элемент управления в окне по его имени
- нажать кнопку в графическом приложении
- ввести текст в окно приложения
- сделать снимок экрана или отдельной области
Примеры запросов агенту
- Покажи открытые окна и активное рабочее пространство.
- Найди в этом окне кнопку сохранения и нажми её.
- Сделай снимок экрана и введи текст в открытое окно.
Как установить hypruse
Командой платформы
claude mcp add --env HYPRUSE_SCREENSHOT_MODE=<HYPRUSE_SCREENSHOT_MODE> --env HYPRUSE_READONLY=<HYPRUSE_READONLY> --env HYPRUSE_CONFINE=<HYPRUSE_CONFINE> --env HYPRUSE_AUTH_GUARD=<HYPRUSE_AUTH_GUARD> --env HYPRUSE_STRICT=<HYPRUSE_STRICT> --transport stdio hypruse -- uvx hypruseВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from hypruse <команда>
Командой платформы
codex mcp add hypruse --env HYPRUSE_SCREENSHOT_MODE=<HYPRUSE_SCREENSHOT_MODE> --env HYPRUSE_READONLY=<HYPRUSE_READONLY> --env HYPRUSE_CONFINE=<HYPRUSE_CONFINE> --env HYPRUSE_AUTH_GUARD=<HYPRUSE_AUTH_GUARD> --env HYPRUSE_STRICT=<HYPRUSE_STRICT> -- uvx hypruseВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from hypruse <команда>
Файл настроек
{
"mcpServers": {
"hypruse": {
"command": "uvx",
"args": [
"hypruse"
],
"env": {
"HYPRUSE_SCREENSHOT_MODE": "<HYPRUSE_SCREENSHOT_MODE>",
"HYPRUSE_READONLY": "<HYPRUSE_READONLY>",
"HYPRUSE_CONFINE": "<HYPRUSE_CONFINE>",
"HYPRUSE_AUTH_GUARD": "<HYPRUSE_AUTH_GUARD>",
"HYPRUSE_STRICT": "<HYPRUSE_STRICT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from hypruse <команда>
Файл настроек
{
"servers": {
"hypruse": {
"type": "stdio",
"command": "uvx",
"args": [
"hypruse"
],
"env": {
"HYPRUSE_SCREENSHOT_MODE": "<HYPRUSE_SCREENSHOT_MODE>",
"HYPRUSE_READONLY": "<HYPRUSE_READONLY>",
"HYPRUSE_CONFINE": "<HYPRUSE_CONFINE>",
"HYPRUSE_AUTH_GUARD": "<HYPRUSE_AUTH_GUARD>",
"HYPRUSE_STRICT": "<HYPRUSE_STRICT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from hypruse <команда>
Командой платформы
gemini mcp add -e HYPRUSE_SCREENSHOT_MODE=<HYPRUSE_SCREENSHOT_MODE> -e HYPRUSE_READONLY=<HYPRUSE_READONLY> -e HYPRUSE_CONFINE=<HYPRUSE_CONFINE> -e HYPRUSE_AUTH_GUARD=<HYPRUSE_AUTH_GUARD> -e HYPRUSE_STRICT=<HYPRUSE_STRICT> hypruse uvx hypruseВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from hypruse <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о hypruse
Как установить hypruse в Claude Code?
Выполните claude mcp add hypruse -- uvx hypruse.
Что делает hypruse?
Он подключает ИИ-агента к рабочему столу Hyprland: позволяет читать состояние окон, делать снимки экрана и управлять вводом.
Что нужно для работы hypruse?
Нужен Hyprland. Дерево доступности доступно в приложениях, которые его предоставляют; для отрисовки меток marks требуется ImageMagick.
