Windows MCP — Установка & Живое демо

Name: Windows MCP MCP Server
Author: CursorTouch

Зачем использовать

Ключевые функции

Доступ к дереву UI Automation — структурированный, не только пиксельный
Screenshot + click + type + комбинации клавиш
Перечисление окон и управление фокусом
Запуск и завершение процессов
Чтение и запись буфера обмена
Работает на Windows 10/11; для большинства приложений права администратора не нужны

Живое демо

Как выглядит на практике

windows-mcp-cursortouch.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "windows-mcp-cursortouch",
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "windows-mcp-cursortouch": {
      "command": {
        "path": "uvx",
        "args": [
          "windows-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add windows-mcp-cursortouch -- uvx windows-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Windows MCP

Автоматизировать Windows-only LOB-приложение без API

👤 RPA-инженеры, уставшие от лицензий UiPath ⏱ ~60 min advanced

Когда использовать: Вендор внутреннего приложения не предоставляет API; нужно, чтобы Claude ежедневно вводил данные.

Предварительные требования

Windows 10/11 с установленным целевым приложением — Стандартная установка
Python 3.10+ для uvx — winget install Python.Python.3.12

Поток

Изучить дерево UI

Запусти приложение BookingSystem.exe, затем выгрузи дерево UI главного окна. Хочу видеть automation ID.✓ Скопировано

→ Дерево показывает элементы с AutomationId — не только безымянные кнопки
Выполнить happy path один раз

Теперь: открой диалог New Booking, заполни клиента «Acme Inc», дату 2026-05-12, сохрани. Сделай screenshot в конце.✓ Скопировано

→ Бронирование сохранено; screenshot подтверждает
Обобщить и зациклить

Прочитай /work/bookings.csv. Для каждой строки повтори flow бронирования. Сохрани screenshots в /work/runs/.✓ Скопировано

→ Каждая строка обработана; screenshot на каждое бронирование

Итог: Headless-автоматизация приложения вендора, воспроизводимая из CSV.

Подводные камни

Приложение использует кастомные элементы (например, WinForms ListView без AutomationId) — Используй клики по координатам для фиксированного положения в окне; задокументируй хрупкость
Модальный диалог перехватывает фокус в середине цикла — Всегда проверяй активное окно перед send_keys; прерывай при неожиданном окне

Сочетать с: filesystem

Извлечь данные из Excel без Excel API

👤 Аналитики, у которых IT не разрешает COM/Office API ⏱ ~15 min intermediate

Когда использовать: Excel открыть можно, но программно — нельзя.

Поток

Открыть файл

Запусти Excel, открой C:\reports\Q2.xlsx, перейди на лист «Sales».✓ Скопировано

→ Заголовок окна показывает имя файла
Скопировать диапазон

Выдели A1:D200, скопируй в буфер обмена, затем прочитай текст из буфера.✓ Скопировано

→ Возвращена таблица с разделителями-табуляцией
Сохранить как CSV через filesystem

Разбери это на строки и сохрани в /tmp/Q2-sales.csv.✓ Скопировано

→ CSV создан

Итог: Данные Excel в формате CSV без обращения к COM API или установки сторонних пакетов.

Подводные камни

Форматы буфера обмена различаются в разных версиях Excel — Попробуй CSV; при необходимости используй TSV через варианты буфера обмена

Сочетать с: filesystem

Захватить баг на рабочем столе для коллеги, пока ты занят

👤 Разработчики, совмещающие разработку с поддержкой ⏱ ~5 min beginner

Когда использовать: Нестабильный баг воспроизводится на твоём Windows-компьютере и нужен чистый screenshot с инструкцией по воспроизведению.

Поток

Воспроизвести и захватить

Сделай screenshot активного окна приложения. Сохрани как bug.png.✓ Скопировано

→ PNG записан
Аннотировать шаги

Перечисли последние 5 видимых пользователю UI-элементов с которыми ты взаимодействовал — заголовки окон, подписи диалогов — чтобы я мог вставить это в тикет.✓ Скопировано

→ Конкретные шаги воспроизведения на уровне элементов

Итог: Хорошо оформленный тикет без переключения вкладок.

Подводные камни

Screenshot содержит личные данные — Захватывай только активное окно, а не весь рабочий стол

Сочетать с: github

Комбинации

Сочетайте с другими MCP — эффект x10

windows-mcp-cursortouch + filesystem

Управлять desktop-приложением по CSV-входным данным

Прочитай /work/orders.csv. Для каждой строки кликай через приложение бронирования.✓ Скопировано

windows-mcp-cursortouch + github

Захватить баг на рабочем столе и открыть issue

Сделай screenshot активного окна, затем создай GitHub issue с PNG и шагами воспроизведения.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
list_windows	(нет)	Найти целевое приложение	бесплатно
get_ui_tree	window_id?	Исследование перед кликом	бесплатно
click	automation_id \| x,y	Кликнуть известный элемент	бесплатно
type_text	text: str	Ввести текст в сфокусированное поле	бесплатно
send_keys	keys: str (например, 'ctrl+s')	Горячие клавиши / модификаторы	бесплатно
screenshot	window_id?, region?	Визуальное подтверждение	бесплатно
launch_process	exe: str	Запустить целевое приложение	бесплатно
read_clipboard	(нет)	После копирования	бесплатно

Стоимость и лимиты

Во что обходится

Квота API: Нет — локальная автоматизация
Токенов на вызов: 50–500 (выгрузки дерева UI могут быть большими)
Деньги: Бесплатный OSS
Совет: Избегай выгрузки полного дерева UI на каждом шаге — сужай по window_id

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: управление локальной desktop-сессией

Хранение учётных данных: Нет — но Claude видит всё, что на экране

Исходящий трафик: Локально; данные не покидают машину, если не добавлен сетевой MCP

Никогда не давайте: автозапуск под учётной записью администратора привязка удалённого доступа

Не запускай на dev-машине с открытыми в браузере чувствительными учётными данными — screenshots могут их захватить
Всегда просматривай дерево UI перед кликами; проверяй целевое окно перед send_keys

Устранение неполадок

Частые ошибки и исправления

Элемент не найден по automation_id

Приложение использует динамические или отсутствующие ID. Используй get_ui_tree и ищи по name/role иерархии

Проверить: Проверяй через Microsoft inspect.exe

Клики попадают на неверное окно

Всегда вызывай set_focus на целевое окно перед click; проверяй активное окно после

Установка uvx падает с ошибкой 'wheel'

Установи Visual C++ Build Tools; некоторые зависимости pywin32 их требуют

Альтернативы

Windows MCP в сравнении

Альтернатива	Когда использовать	Компромисс
Anthropic Computer Use (пиксельный)	Нужно кросс-платформенное управление по пикселям	На Windows менее надёжен, чем UIA-подход; более хрупкий при изменении макета
AutoIt / PowerShell	Скриптование без LLM	Нет агентного слоя; только ручное скриптование
Peekaboo (macOS)	Ты на macOS, не Windows	Другая ОС; не взаимозаменяемы

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills