DesktopManager MCP
DesktopManager дает агенту окна и мониторы Windows через MCP: старт только на чтение, изменения включаются отдельными флагами.
- 108 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- С флагом `--allow-mutations` агент кликает, вводит текст и запускает процессы в окнах Windows.
- Снимки экрана и текст окон могут раскрыть личные данные.
Установка
- Работает в
Ручная установка
Install-Module DesktopManager -Force -VerboseПервая команда установки из README ставит модуль PowerShell; CLI `desktopmanager mcp serve` запускает MCP-сервер.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- С флагом `--allow-mutations` агент кликает, вводит текст и запускает процессы в окнах Windows.
- Снимки экрана и текст окон могут раскрыть личные данные.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
DesktopManager, набор для автоматизации рабочего стола Windows: библиотека .NET, модуль PowerShell, CLI `desktopmanager`, трей-приложение и MCP-сервер. Агент подключается командой `desktopmanager mcp serve` по stdio, и сервер стартует в режиме чтения: список окон и мониторов, координаты, текст и элементы окна, снимки экрана. Изменяющие инструменты вроде `click_window_point`, `type_window_text`, `send_window_keys`, `move_window` и `launch_process` включаются флагом `--allow-mutations`. Системные настройки требуют еще `--allow-system-settings`, есть `--allow-process` и `--deny-process` для ограничения приложений, `--dry-run` для проверки без действий. Кроме MCP библиотека управляет обоями, яркостью, разрешением, раскладкой окон и звуком.
Для кого. Разработчикам и тестировщикам под Windows, которым нужно дать агенту управление окнами и проверку интерфейса с понятными ограничениями.
Подходит, если
- Агент проверяет, открылось ли окно и что в нем написано, без изменений.
- Нужен снимок монитора или окна для анализа.
- Автотест кликает по элементам приложения и сверяет базовый скриншот.
- Раскладка окон и мониторов сохраняется и восстанавливается скриптом.
Не подходит, если
- Система работает на Linux: адаптеры MCP и окна рассчитаны на Windows.
- Агенту нельзя давать ввод с клавиатуры и мыши.
- Нужен запуск на рабочей машине с чужими окнами, не ограниченный списком процессов.
Пример запроса к агенту
Покажи через DesktopManager список открытых окон и сделай снимок окна редактора, ничего не меняя.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Окна, трей и MCP работают только в Windows, портативный слой для обоев и мониторов есть также для macOS, GNOME и KDE. Управление устройствами и драйверами в MCP доступно только для чтения. Глобальный режим полета использует недокументированный COM-контракт и включается флагом `--allow-experimental`. После клика и ввода в чужие окна эффект нельзя откатить, поэтому начинайте с `--dry-run`. Установка идет из PowerShell Gallery или MSI-релиза, а для MCP нужен готовый исполняемый файл `desktopmanager`.
Как отключить. Уберите запись `desktopmanager mcp serve` из конфигурации MCP клиента. Модуль удаляется командой `Uninstall-Module DesktopManager`, трей-приложение через удаление MSI.
Частые вопросы
Как запустить MCP-сервер?
Выполните `desktopmanager mcp serve`. Он стартует в режиме чтения.
Как разрешить клики и ввод?
Добавьте `--allow-mutations`. Для системных настроек нужен еще `--allow-system-settings`.
Как ограничить приложения?
Флаги `--allow-process <шаблон>` и `--deny-process <шаблон>` задают допустимые процессы.
Есть ли предпросмотр действий?
Да, `--dry-run` показывает результат изменяющих вызовов без выполнения.
Какие снимки умеет делать?
Инструменты `screenshot_desktop` и `screenshot_window` снимают весь рабочий стол или одно окно; есть сохранение эталонов и сравнение с ними.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и CLI wincli: агент управляет окнами Windows по именам кнопок и полей через UI Automation, без координат скриншота
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
Агент водит мышью, печатает текст, управляет окнами и снимает PNG-скриншоты рабочего стола Windows через AutoIt.
MCP-сервер дает агенту видеть экран и управлять macOS, Windows и Linux: скриншоты, клики, ввод, OCR и память экрана
MCP-сервер для удаленного управления Windows: снимки экрана, PowerShell, файлы, мышь и клавиатура, реестр и OCR
MCP-сервер для Windows: агент двигает мышь, нажимает клавиши, управляет окнами и делает снимки экрана
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| DesktopManager (эта карточка) | нет | не нужна | 108 | |
| MCP Windows Desktop Automation | нет | не нужна | 119 | автоматизация окон Windows через MCP, а DesktopManager стартует только на чтение и добавляет флаги разрешений и фильтр процессов |
| Windows MCP Server | нет | не нужна | 133 | сервер управления Windows для агентов, тогда как здесь тот же слой доступен как модуль PowerShell, CLI и библиотека .NET |
Коротко о README
В README изложены пять способов работы: библиотека, модуль, CLI, MCP и трей, с таблицей выбора. Отдельный файл `Docs/DesktopManager.Mcp.md` перечисляет инструменты и флаги безопасности.