Windows-MCP
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
- 11 574 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Дает агенту прямое управление рабочим столом Windows: клики, ввод, открытие приложений и работу с файлами
- Выполняет команды PowerShell и обращается к реестру, а при удаленном транспорте открывает доступ по сети
Установка
- Работает в
Ручная установка
{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": ["windows-mcp", "serve"]
}
}
}Требуется установленный uv. Для транспорта по HTTP добавьте --transport streamable-http и адрес.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Дает агенту прямое управление рабочим столом Windows: клики, ввод, открытие приложений и работу с файлами
- Выполняет команды PowerShell и обращается к реестру, а при удаленном транспорте открывает доступ по сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает языковую модель с рабочим столом Windows и дает агенту инструменты управления системой. Он снимает скриншот с позицией курсора и списком окон, строит дерево элементов интерфейса через UI Automation, эмулирует клавиатуру и мышь, открывает и переключает приложения, работает с файлами, буфером обмена, процессами, реестром и уведомлениями, выполняет команды PowerShell. Есть отдельный режим для браузера, который оставляет только содержимое веб-страницы и отбрасывает элементы самого браузера, поддерживает Chrome, Edge и Firefox. Сервер не опирается на компьютерное зрение и работает с любой моделью. Запускается по stdio для локального клиента или по HTTP и SSE для удаленного доступа, во втором случае можно включить ключ доступа, список разрешенных адресов, TLS и OAuth.
Для кого. Для инженеров и QA, которым нужно, чтобы агент управлял приложениями и интерфейсом Windows и прогонял сценарии.
Подходит, если
- Нужно, чтобы агент открывал приложения Windows, кликал и печатал за пользователя
- Нужно снять состояние окон и элементов интерфейса для проверки или автоматизации
- Нужно автоматизировать сценарий в браузере или прогнать ручной QA-тест
Не подходит, если
- Целевая система не Windows, сервер использует Windows API для управления интерфейсом
- Нельзя давать агенту прямой доступ к рабочему столу и командам оболочки
Пример запроса к агенту
Открой калькулятор, посчитай в нем сумму и пришли скриншот результатаMCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
Переменные окружения
WINDOWS_MCP_AUTH_KEYсекрет- Bearer-токен для всех HTTP-запросов при удаленном доступе, альтернатива флагу --auth-key.
WINDOWS_MCP_IP_ALLOWLIST- Список разрешенных адресов или подсетей CIDR клиентов через запятую.
WINDOWS_MCP_OAUTH_CLIENT_SECRETсекрет- Секрет клиента OAuth для HTTP-транспортов, задается вместе с WINDOWS_MCP_OAUTH_CLIENT_ID.
WINDOWS_MCP_SCREENSHOT_SCALE- Коэффициент масштаба скриншотов от 0.1 до 1.0, помогает уложиться в лимит размера результата на дисплеях высокого разрешения.
Ограничения
Работает только на Windows, заявлена поддержка от Windows 7 до 11, нужны Python 3.13+ и менеджер пакетов uv. Как язык системы предпочтителен английский, иначе инструмент App рекомендуют отключить. Первый запуск может занять минуту-две из-за установки зависимостей и иногда завершается таймаутом, тогда сервер перезапускают. При удаленном доступе по HTTP защиту нужно настраивать самостоятельно: ключ доступа, список адресов, TLS и OAuth задаются флагами или переменными окружения.
Как отключить. Уберите запись windows-mcp из конфигурации MCP клиента и перезапустите его. Если ставили как фоновую задачу командой windows-mcp install, удалите ее командой windows-mcp uninstall. Пакет удаляется через uv tool uninstall windows-mcp.
Частые вопросы
Нужна ли отдельная модель компьютерного зрения?
Нет. Сервер строит дерево элементов интерфейса через UI Automation и работает с любой языковой моделью, зрение не обязательно.
Можно ли открыть доступ по сети?
Да, есть транспорты HTTP и SSE, но защиту вы настраиваете сами: ключ доступа, список разрешенных адресов, TLS и OAuth задаются флагами или переменными окружения.
Чем Windows-MCP отличается от других инструментов управления компьютером?
Сервер связывает модель с рабочим столом Windows напрямую: снимает скриншот с позицией курсора и списком окон, строит дерево элементов интерфейса, кликает, печатает, работает с файлами и PowerShell.
Как скачать и подключить Windows-MCP?
Скачивать отдельно ничего не нужно. В конфиг клиента добавляется сервер windows-mcp с командой uvx, как в блоке установки. Подходит для Claude Desktop, Claude Code и Cursor. Риск высокий: агент управляет вашей системой.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и CLI wincli: агент управляет окнами Windows по именам кнопок и полей через UI Automation, без координат скриншота
MCP-сервер для Windows: агент двигает мышь, нажимает клавиши, управляет окнами и делает снимки экрана
MCP-сервер для удаленного управления Windows: снимки экрана, PowerShell, файлы, мышь и клавиатура, реестр и OCR
Агент водит мышью, печатает текст, управляет окнами и снимает PNG-скриншоты рабочего стола Windows через AutoIt.
MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
MCP-сервер дает агенту видеть экран и управлять macOS, Windows и Linux: скриншоты, клики, ввод, OCR и память экрана
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Windows-MCP (эта карточка) | нет | не нужна | 11 574 | |
| agent-desktop | нет | 22 602 | CLI на Rust для macOS | |
| Ghost OS | нет | не нужна | 1 686 | MCP-сервер на Swift для macOS |
| WinUtil CN MCP | нет | не нужна | 1 054 | MCP-сервер для Windows |
Коротко о README
README описывает Windows-MCP как MCP-сервер, который связывает агентов с Windows и дает инструменты навигации по файлам, управления приложениями, работы с интерфейсом и QA-тестов. Установка идет через uv и uvx windows-mcp serve, доступны транспорты stdio, streamable-http и sse, а также установка фоновой задачей через windows-mcp install. Подробно расписана настройка в Claude Desktop, Perplexity, Claude Code и через WSL. Отдельные разделы посвящены безопасности удаленного доступа, выбору включенных инструментов и переменным окружения. Пакет опубликован на PyPI и в реестре MCP, лицензия MIT.