hypruse
hypruse — MCP-сервер сообщества (автор — IlyasKhallouki). Управление компьютером в Hyprland: состояние рабочего стола и нативный ввод. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- IlyasKhallouki
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- python
Уровень риска: high
Управляет мышью, клавиатурой и запуском приложений на рабочем столе Hyprland; есть режим только чтения.
Настройка клиентов
{
"code": "claude mcp add -s user hypruse -- uvx hypruse",
"lang": "sh",
"verified": "docs"
}
Что умеет
hypruse — MCP-сервер, набор команд оболочки и навык для агента, которые отдают ИИ ваш рабочий стол Hyprland: дерево окон, скриншоты, нажатия на элементы по имени, мышь и клавиатуру. Главная идея — агент работает в приложениях на своих рабочих столах, пока вы продолжаете работать на своих. Сервер работает на обычном Hyprland и на Omarchy без плагинов композитора.
Автор объясняет мотивацию так: управление компьютером есть на macOS и Windows, а в Linux-версиях приложений его нет — в документации Claude Desktop для Linux прямо сказано, что эта функция недоступна. Hyprland же через IPC и протоколы Wayland даёт всё нужное агенту.
Инструменты:
desktop— снимок за один вызов: мониторы, рабочие столы, окна с адресами, классами, заголовками и геометрией, активное окно, курсор и слои (лаунчеры, панели, уведомления);screenshotиzoom— скриншот монитора, окна (на Hyprland 0.54+ с grim 1.5+ даже скрытого) или области и уточняющий снимок перед кликом по мелкому элементу;uiиmarks— дерево доступности окна (AT-SPI) с элементами по имени и точными координатами, а также скриншот с пронумерованными элементами;click_ui— нажатие на элемент по имени или номеру; в чужом окне — через действие доступности, без перехвата курсора;pointerиkeyboard— мышь и ввод текста или сочетаний клавиш;hypr— переключение рабочих столов, фокус, перемещение и закрытие окон;launch— запуск приложения, по умолчанию на рабочем столе агента;bindsиuse_bind— ваши горячие клавиши и их выполнение;sequence— цепочка действий за один вызов с остановкой при неожиданном изменении;wait_for— ожидание событий композитора;clipboard— буфер обмена, только приHYPRUSE_CLIPBOARD=1.
Каждый инструмент доступен и как команда hypruse для агентов, которые запускают команды вместо MCP.
Кому подойдёт
Пользователям Hyprland и Omarchy, которые хотят, чтобы агент сам нажимал кнопки в настройках и приложениях Linux. Похожие серверы — в категории автоматизация.
Установка
Нужны Hyprland, grim, wtype и для варианта через uvx — uv. Установка: yay -S hypruse из AUR или uv tool install hypruse. Команда hypruse init находит клиентов (Claude Code, Codex, Claude Desktop), с вашего согласия регистрирует сервер, предлагает навык и запускает диагностику hypruse doctor.
Режим только для чтения: HYPRUSE_READONLY=1 оставляет лишь наблюдение (desktop, screenshot, zoom, ui, marks, binds, wait_for) — агент видит, но не нажимает и не запускает. Автор советует начать с него.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add -s user hypruse -- uvx hypruseКонфиг Claude Desktop — ~/.config/Claude/claude_desktop_config.json. Режим image нужен, потому что Desktop показывает картинки прямо в чате и не умеет читать файлы. Приложение должно работать прямо в сессии Hyprland: из виртуальной машины или контейнера сервер композитор не увидит.
Проверка
Попросите: «С помощью hypruse покажи окна на каждом из моих рабочих столов».
Примеры задач
Открой настройки на своём рабочем столе и включи режим «Не беспокоить».Запусти браузер в фоне и найди там расписание поездов.Риски
- Полный контроль над рабочим столом. Агент получает мышь, клавиатуру, содержимое экрана и запуск приложений; держите
pointer,keyboard,hyprиlaunchна ручном подтверждении. - Внедрение инструкций. Заголовки окон и тексты элементов попадают к агенту как есть и могут содержать вредные указания.
- Защитные флаги:
HYPRUSE_BACKGROUND=1ограничивает ввод окнами агента,HYPRUSE_CONFINE— выбранными окнами,HYPRUSE_AUTH_GUARD(включён по умолчанию) запрещает вводить что-либо в системные окна авторизации,HYPRUSE_DRYRUNтолько показывает, что было бы сделано. Индикатор в Waybar и «тревожная» клавиша останавливают агента.
Частые вопросы
Нужен ли плагин для Hyprland?
Нет, работает на стандартном Hyprland.
Помешает ли агент моей работе?
В фоновом режиме он работает на своих рабочих столах, не трогая ваш курсор и фокус.
Можно ли запретить агенту действия?
Да, переменная HYPRUSE_READONLY=1 оставляет только наблюдение.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
commands
Сервер из UI-TARS-desktop для запуска произвольных команд.
Windows-MCP
Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.
agent-device
Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.
MCP-сервер для анализа сбоев в WinDbg
Анализ аварийных дампов Windows через WinDbg и CDB.