agent-workspace-linux MCP

MCP-сервер и CLI дают агенту собственный скрытый рабочий стол Linux с X11 или Wayland, не трогая ваш экран и браузер

219 ★ репозитория
Последний коммит 9 нояб. 2026
MIT

agent-sh/agent-workspace-linuxАвтор:agent-sh

Установка

Работает в: Claude Code
Codex
SourceCraft
Koda
Coddy

Ручная установка

npm install -g @agent-sh/agent-workspace-linux

Скачивает готовый бинарный файл и проверяет sha256; системные пакеты (xvfb, openbox, xdotool и другие) ставятся отдельно через apt.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Агент управляет мышью, клавиатурой и окнами скрытого рабочего стола и запускает приложения от вашего имени
Рабочая область не песочница: приложения видят ваши файлы и сеть, а хост-рантаймы ретранслируют связку ключей и SSH-агент

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

agent-workspace-linux создает для агента отдельный рабочий стол: закрытый дисплей X11 или родной Wayland со своим оконным менеджером или композитором и сокетом управления. Агент, которому нужно «пользоваться компьютером», обычно захватывает вашу мышь и вошедший браузер, а здесь все изображения, ввод, окна, буфер обмена и управление браузером направлены только в рабочую область, ваш экран остается нетронутым. Доступны бэкенды X11, i3, KWin, GNOME, Hyprland и COSMIC. Команды workspace start, launch, observe и stop создают область, запускают приложения и снимают скриншоты, а плавающий просмотрщик (viewer) показывает происходящее и дает приостановить или остановить агента. Для создания области нужно явное подтверждение --ack-hidden-workspace. Список разрешенных программ задается файлом --permissions, и он служит жесткой границей. Сервер MCP запускается командой agent-workspace-linux mcp, инструменты размечены как только чтение, запись, разрушающие или открытые, а в комплекте идет скилл маршрутизации.

Для кого. Разработчикам и QA-инженерам на Linux, которые хотят, чтобы агент тестировал приложения и сайты или ходил по вебу на отдельном рабочем столе.

Подходит, если

Агент должен проверить GUI-приложение или сайт, не перехватывая вашу мышь и браузер
Веб-задачи идут в браузере, за которым можно наблюдать и который можно остановить
Нужен чистый профиль браузера или ваш собственный вход, в отдельной области
Для скриншотов и автоматизации окон нужен Wayland-композитор GNOME, KWin, Hyprland или COSMIC

Не подходит, если

Нужна изоляция для недоверенного кода: рабочая область не песочница, приложения запускаются от вашего имени
Платформа не Linux: проект работает только на нем
Нужна защита от других пользователей машины: модель доверия рассчитана на одного пользователя

Пример запроса к агенту

Создай скрытое рабочее пространство, открой в нем мой веб-сервис в браузере, пройди сценарий входа и сохрани скриншот

MCP

Транспорт: stdio
Авторизация: не нужна

Переменные окружения

AGENT_WORKSPACE_PERMISSIONS: Путь к файлу со списком разрешенных программ

Ограничения

Только Linux, просмотрщик проверен на X11 и XWayland, родной Wayland еще дорабатывается. Проект до версии 1.0, интерфейсы и схемы инструментов могут меняться. Песочницей рабочая область не служит: приложения запускаются с вашими файлами и сетью, хост-рантаймы ретранслируют связку ключей и SSH-агент, поэтому не запускайте код, которому не доверяете. Один процесс на профиль: второй запуск приложения передается уже работающему экземпляру.

Как отключить. Остановите область командой agent-workspace-linux workspace stop и снимите пакет через npm uninstall -g @agent-sh/agent-workspace-linux или удалите бинарный файл из ~/.local/bin. Запись MCP уберите из настроек клиента.

Частые вопросы

Чем это отличается от обычного управления компьютером?

Обычно агент двигает вашу мышь, перехватывает фокус и использует ваш вошедший браузер. Здесь у агента отдельный дисплей и шина сеансов, поэтому его ввод, скриншоты и окна не попадают на ваш рабочий стол.

Какие бэкенды рабочего стола поддерживаются?

X11 (по умолчанию), i3, KWin, GNOME, Hyprland и COSMIC. Бэкенд выбирают флагом --session при workspace start или в вызове MCP. Для GNOME можно указать версию и масштаб.

Как остановить агента?

Через плавающий просмотрщик командой viewer: пауза, режим только чтения или остановка. Если состояние управления не читается, изменяющие вызовы завершаются отказом.

Как установить?

Системные пакеты через apt (xvfb, openbox, xdotool и другие), затем бинарный файл: ./install.sh, npm install -g @agent-sh/agent-workspace-linux или cargo install --git. Сервер регистрируется командой agent-workspace-linux mcp.

Можно ли ходить по вебу своим профилем?

Да, но приложения работают от вашего имени, поэтому веб-задачи идут либо в одноразовом профиле, либо с вашими логинами по вашему выбору. Для Chromium задавайте отдельный --user-data-dir, иначе окно откроется в уже запущенном браузере.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

agent-device

CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах

CLIРасширенный доступ5,4 тыс.

kwin-mcp

MCP-сервер на 29 инструментов запускает Wayland-приложения в виртуальном сеансе KDE Plasma 6 и читает дерево доступности

MCP-серверШирокий доступ80

sandbox-mcp

CLI sbx и MCP-сервер запускают приложение агента в чистой Windows Sandbox и возвращают отчет со скриншотами и сбоями

CLIШирокий доступ422

Reticle

MCP-сервер, который проверяет, правда ли агент закончил: гоняет реальное приложение и возвращает вердикт прошло, не прошло, неясно с указанием файла и строки

MCP-серверРасширенный доступ1,3 тыс.

e2e

Официальный

Агент получает живую сессию вашего приложения на вебе, iOS или Android, видит экран, пишет тесты и сам проверяет правки.

MCP-серверРасширенный доступ13,8 тыс.

BrowserStack MCP Server — тесты на реальных устройствах

BrowserStack MCP Server