Windows-MCP

MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell

  • 11 574 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

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

Почему такой уровень

  • Дает агенту прямое управление рабочим столом Windows: клики, ввод, открытие приложений и работу с файлами
  • Выполняет команды PowerShell и обращается к реестру, а при удаленном транспорте открывает доступ по сети
Все причины и проверки

cursortouch/windows-mcp

Установка

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

{
  "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-серверШирокий доступ131Звезды репозитория

MCP-сервер для Windows: агент двигает мышь, нажимает клавиши, управляет окнами и делает снимки экрана

MCP-серверШирокий доступ334Звезды репозитория

MCP-сервер для удаленного управления Windows: снимки экрана, PowerShell, файлы, мышь и клавиатура, реестр и OCR

MCP-серверШирокий доступ221Звезды репозитория

Агент водит мышью, печатает текст, управляет окнами и снимает PNG-скриншоты рабочего стола Windows через AutoIt.

MCP-серверШирокий доступ119Звезды репозитория

MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API

MCP-серверШирокий доступ415Звезды репозитория
Официальный

MCP-сервер дает агенту видеть экран и управлять macOS, Windows и Linux: скриншоты, клики, ввод, OCR и память экрана

MCP-серверШирокий доступ92Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Windows-MCP (эта карточка)нетне нужна11 574
agent-desktopнет22 602CLI на Rust для macOS
Ghost OSнетне нужна1 686MCP-сервер на Swift для macOS
WinUtil CN MCPнетне нужна1 054MCP-сервер для 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.

Бейдж для README

Сообщить о проблеме