Windows MCP Server
MCP-сервер и CLI wincli: агент управляет окнами Windows по именам кнопок и полей через UI Automation, без координат скриншота
- 129 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент управляет реальным рабочим столом Windows, включая все программы с выполненным входом.
- Отключенные инструменты MCP не образуют песочницу и не ограничивают команды CLI.
Установка
- Работает в
Ручная установка
dotnet publish .\src\Sbroenne.WindowsMcp.Cli\Sbroenne.WindowsMcp.Cli.csproj -c Release -r win-x64 --self-contained true -o .\artifacts\wincliСборка CLI `wincli` из исходников, для Windows ARM64 замените `win-x64` на `win-arm64`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент управляет реальным рабочим столом Windows, включая все программы с выполненным входом.
- Отключенные инструменты MCP не образуют песочницу и не ограничивают команды CLI.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Windows MCP Server управляет приложениями Windows через UI Automation: агент находит кнопку или поле по имени и действует с ним напрямую. Он запускает программы, расставляет окна, заполняет формы, читает текст и таблицы, работает со стандартными диалогами открытия и сохранения файлов. Скриншоты, мышь и клавиатура тоже есть, они нужны для рисунков, игр и программ без данных доступности. Те же возможности открывает CLI `wincli` для агентов с доступом к терминалу. Повторяющийся сценарий хранится в файле проекта как массив шагов `steps`.
Для кого. Тем, кто поручает агенту рутину в настольных программах Windows: формы, таблицы и сохранение файлов в Office и браузере.
Подходит, если
- Форму в настольной программе без API нужно заполнить каждый день одними и теми же данными.
- В таблице в окне надо найти строки с пустыми значениями.
- Сохранение файла через диалог «Сохранить как» повторяется в каждом сценарии.
- Скриншоты съедают бюджет токенов, а нужно прочитать одно поле окна.
Не подходит, если
- На рабочем столе открыты чужие сессии и вкладки, которых агент не должен касаться.
- Программа запущена от администратора, а у агента таких прав нет.
- Требуется Mac или Linux: сервер рассчитан на Windows 10 и 11.
- Windows с неанглийским интерфейсом: помощники файловых диалогов опираются на английские подписи.
Пример запроса к агенту
Открой Блокнот, напечатай «Привет от Windows MCP» и сохрани файл windows-mcp-demo.txt на рабочий стол.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Сервер работает только в Windows 10 и 11 и управляет реальным рабочим столом, общим для всех подключенных агентов. Охват UI Automation зависит от программы: WinForms, WinUI 3, Electron, Edge и Chrome проверены тестами, остальное без гарантии. Программой, запущенной от администратора, агент без таких прав управлять не сможет. Запросы безопасности Windows подтверждает человек. Отключение инструментов MCP не заменяет песочницу и не ограничивает команды CLI.
Как отключить. Удалите сервер из конфигурации MCP клиента или снимите расширение VS Code. Для CLI остановите службу `wincli` и удалите папку с программой.
Частые вопросы
Как поставить Windows MCP Server в Cursor или Claude Desktop?
Скачайте пакет под свой процессор со страницы Releases, распакуйте и добавьте исполняемый файл сервера в конфигурацию MCP. Среда выполнения уже внутри пакета, отдельно ставить .NET не нужно.
Чем MCP отличается от CLI wincli?
Возможности те же. MCP подходит ассистенту, который уже работает с MCP-инструментами. `wincli` нужен агенту с терминалом, ему не требуется отдельное MCP-подключение.
Что делать, если программа не отдает элементы управления?
Для рисунков, игр и программ без данных доступности остаются скриншоты, мышь, клавиатура и распознавание текста. Они встроены в те же инструменты.
Как начать безопасно?
Откройте тестовый документ и дайте агенту простую задачу, например сохранить файл в Блокноте. Пока агент работает, держите руки подальше от мыши и клавиатуры, и оставьте в клиенте подтверждение действий.
Какие программы проверены?
Интеграционные тесты есть для WinForms, WinUI 3, Electron, Edge и Chrome. Для остальных программ охват зависит от данных доступности, которые они отдают.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
Агент водит мышью, печатает текст, управляет окнами и снимает PNG-скриншоты рабочего стола Windows через AutoIt.
MCP-сервер для Windows: агент двигает мышь, нажимает клавиши, управляет окнами и делает снимки экрана
MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
MCP-сервер дает агенту управлять окнами и приложениями: он читает экран как структуру и действует по имени элемента
MCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Windows MCP Server (эта карточка) | нет | не нужна | 129 | |
| Windows-MCP | нет | не нужна | 11 150 | windows-mcp тоже управляет Windows; Windows MCP Server строит работу на UI Automation и дает тот же набор команд через CLI wincli. |
| dsh-computer-use-win | нет | не нужна | 522 | dsh-computer-use-win — плагин управления рабочим столом для DeepSeek Harness; Windows MCP Server подключается к любому клиенту MCP и к агентам с терминалом. |
Коротко о README
Репозиторий содержит MCP-сервер на .NET, расширение для VS Code и CLI `wincli`. README объясняет работу через элементы управления вместо скриншотов, приводит замеры токенов на реальных задачах и перечисляет ограничения и настройки безопасности.