hypruse

hypruse — MCP-сервер сообщества (автор — IlyasKhallouki). Управление компьютером в Hyprland: состояние рабочего стола и нативный ввод. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
IlyasKhallouki
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
python

Уровень риска: high

Управляет мышью, клавиатурой и запуском приложений на рабочем столе Hyprland; есть режим только чтения.

Настройка клиентов

claude-code
{
    "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 для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Источники