kwin-mcp
MCP-сервер на 29 инструментов запускает Wayland-приложения в виртуальном сеансе KDE Plasma 6 и читает дерево доступности
- 79 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- В живом режиме агент нажимает кнопки и вводит текст в настоящие приложения вашего рабочего стола и читает буфер обмена
- Изоляция виртуального сеанса затрагивает только окна и ввод: запущенные приложения видят ваши файлы и сеть
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kwin-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- В живом режиме агент нажимает кнопки и вводит текст в настоящие приложения вашего рабочего стола и читает буфер обмена
- Изоляция виртуального сеанса затрагивает только окна и ввод: запущенные приложения видят ваши файлы и сеть
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
kwin-mcp — MCP-сервер для автоматизации графического интерфейса Linux на KDE Plasma 6 с Wayland. Агент запускает любое приложение Wayland в изолированном виртуальном сеансе, где у него свой композитор `kwin_wayland --virtual`, и не трогает ваш рабочий стол: окна и ввод пользователя остаются отдельными. У сервера 29 инструментов: управление сеансом, запуск приложений и логи, снимки экрана, дерево доступности AT-SPI2, окна, мышь, клавиатура, касания, буфер обмена и D-Bus. Элементы интерфейса приходят структурированными, с ролями и координатами, поэтому снимки экрана для действий не нужны. Есть и режим подключения к живому рабочему столу или к KWin в контейнере. Вместе с MCP идет скилл `kwin-desktop-automation`.
Для кого. Разработчикам графических приложений на Qt, GTK и Electron под KDE Plasma, которым нужны сквозные тесты в CI, и пользователям Linux, которые отдают агенту управление программами.
Подходит, если
- Вы пишете сквозные тесты для Qt-приложения и гоняете их без физического дисплея
- Агент должен запустить `kcalc`, нажать кнопки и подтвердить результат снимком экрана
- В CI на GitHub Actions или GitLab требуется проверка интерфейса на Linux
- Вы делитесь рабочим столом с агентом и просите его пройти по настройкам вместе с вами
- Киоск или встроенное устройство на KDE нуждается в автоматическом прогоне сценариев
Не подходит, если
- У вас Windows, macOS или Linux без KDE Plasma 6 на Wayland: сервер использует закрытые интерфейсы KWin
- Нужна песочница для файлов и сети: изоляция касается только окон и ввода
- Агент должен вводить текст в раскладках кроме US QWERTY без запасного способа через буфер обмена
- Запросы идут к живому рабочему столу с несохраненной работой, и вы не готовы к закрытию окон
Пример запроса к агенту
Запусти kcalc в виртуальном сеансе KWin, нажми кнопки, чтобы сложить два и три, и сделай снимок экрана с результатомMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны KDE Plasma 6 на Wayland, Python 3.12 или новее и системные пакеты: `libei1`, `spectacle`, `at-spi2-core`, плюс компилятор для сборки PyGObject и dbus-python при установке через `uv` или `pip`. Набор текста методом `keys` поддерживает только раскладку US QWERTY, остальные символы идут методом `unicode`, который временно использует буфер обмена. Изоляция относится к окнам и вводу, а не к файлам и сети, и это не песочница безопасности. В живом режиме действия затрагивают настоящие программы, закрытие окна спрашивает у вас подтверждение.
Как отключить. Удалите запись `kwin-mcp` из `.mcp.json` или плагин командой `/plugin` и при необходимости выполните `uv tool uninstall kwin-mcp`. Запущенный сеанс завершает инструмент `session_stop`.
Частые вопросы
Как подключить kwin-mcp к Claude Code?
Добавьте в `.mcp.json` сервер с командой `uvx` и аргументом `kwin-mcp`. Быстрее поставить плагин: `/plugin marketplace add isac322/kwin-mcp` и `/plugin install kwin-mcp@kwin-mcp`, он добавляет и скилл.
Трогает ли сервер мой рабочий стол?
В виртуальном сеансе нет: окна живут в отдельном композиторе. В живом режиме действия идут по настоящему рабочему столу, его включают через `session_connect` или флаг `--default-live-session`.
Нужны ли снимки экрана для кликов?
Нет. Дерево доступности AT-SPI2 дает элементам ссылки `ref`, и любой инструмент мыши или касания принимает их как цель, а `element_act` вызывает действие без координат.
Что с вводом не на английской раскладке?
Метод `keyboard_type(method="keys")` принимает только US QWERTY. Для остальных символов выберите `method="unicode"`, он вставляет текст через буфер обмена.
Можно ли запускать в CI?
Да, виртуальный сеанс не требует X11 и физического дисплея, поэтому подходит для Linux-раннеров GitHub Actions и GitLab при установленных зависимостях.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и CLI дают агенту собственный скрытый рабочий стол Linux с X11 или Wayland, не трогая ваш экран и браузер
MCP-сервер на Playwright от сообщества: браузерная автоматизация, скриншоты, эмуляция устройств и генерация тестового кода
Официальный отладчик MCP-серверов: веб-интерфейс, CLI для автоматизации и терминальный интерфейс в одном пакете
kogiQA MCP дает агенту браузер, который находит элементы страницы без селекторов, для отладки веб-приложений и e2e-тестов
Официальный MCP-сервер Testkube: агент запускает тестовые воркфлоу в Kubernetes, читает логи, артефакты и метрики прогонов.
Команда npx @wong2/mcp-cli запускает MCP-серверы из конфига Claude Desktop, показывает инструменты и вызывает их из терминала.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| kwin-mcp (эта карточка) | нет | не нужна | 79 | |
| computer-use-linux | да | не нужна | 867 | управляет Linux-десктопом общего вида; kwin-mcp работает в изолированном сеансе KWin и читает дерево доступности |
| Open Computer Use | нет | не нужна | 2 940 | общий компьютерный агент; здесь специализация на KDE Plasma 6 и Wayland с 29 типизированными инструментами |
Коротко о README
README перечисляет возможности и сценарии, шаги установки с системными зависимостями, настройку для Claude Code, OpenCode и других клиентов, флаги сервера и все 29 инструментов с параметрами. Отдельные разделы объясняют устройство, требования, миграцию с 0.11 и ограничения.