Windows-MCP

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

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

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

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

cursortouch/windows-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/windows-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio Windows-MCP -- uvx windows-mcp==0.8.5

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "Windows-MCP": {
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "Windows-MCP": {
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Выполните в терминале

code --add-mcp '{"name":"Windows-MCP","type":"stdio","command":"uvx","args":["windows-mcp==0.8.5"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "Windows-MCP": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Выполните в терминале

codex mcp add Windows-MCP -- uvx windows-mcp==0.8.5

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.Windows-MCP]
command = "uvx"
args = ["windows-mcp==0.8.5"]

Если файл уже есть, допишите блок в конец.

Выполните в терминале

gemini mcp add -s user Windows-MCP uvx windows-mcp==0.8.5

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "Windows-MCP": {
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "Windows-MCP": {
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "Windows-MCP": {
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "Windows-MCP": {
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "Windows-MCP": {
      "type": "local",
      "command": [
        "uvx",
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "Windows-MCP": {
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "Windows-MCP": {
      "command": "uvx",
      "args": [
        "windows-mcp==0.8.5"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Понадобится: uv

Сверено с репозиторием 24 сент. 2026, коммит 32e4723.

Текст для агента

Поставь uv, затем пропиши MCP-сервер в конфигурацию клиента: command uvx, args windows-mcp и serve. Для транспорта по HTTP запускай uvx windows-mcp serve --transport streamable-http --host localhost --port 8000.

Другие способы из описания автора
{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": ["windows-mcp", "serve"]
    }
  }
}

Требуется установленный uv. Для транспорта по HTTP добавьте --transport streamable-http и адрес.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер связывает языковую модель с рабочим столом Windows и дает агенту инструменты управления системой. Он снимает скриншот с позицией курсора и списком окон, строит дерево элементов интерфейса через UI Automation, эмулирует клавиатуру и мышь, открывает и переключает приложения, работает с файлами, буфером обмена, процессами, реестром и уведомлениями, выполняет команды PowerShell. Есть отдельный режим для браузера, который оставляет только содержимое веб-страницы и отбрасывает элементы самого браузера, поддерживает Chrome, Edge и Firefox. Сервер не опирается на компьютерное зрение и работает с любой моделью. Запускается по stdio для локального клиента или по HTTP и SSE для удаленного доступа, во втором случае можно включить ключ доступа, список разрешенных адресов, TLS и OAuth.

Для кого. Для инженеров и QA, которым нужно, чтобы агент управлял приложениями и интерфейсом Windows и прогонял сценарии.

Подходит, если

  • Нужно, чтобы агент открывал приложения Windows, кликал и печатал за пользователя
  • Нужно снять состояние окон и элементов интерфейса для проверки или автоматизации
  • Нужно автоматизировать сценарий в браузере или прогнать ручной QA-тест

Не подходит, если

  • Целевая система не Windows, сервер использует Windows API для управления интерфейсом
  • Нельзя давать агенту прямой доступ к рабочему столу и командам оболочки

Пример запроса к агенту

Открой калькулятор, посчитай в нем сумму и пришли скриншот результата

Ограничения

Работает только на 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.

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: клики, ввод, открытие приложений и работу с файлами
  • Выполняет команды PowerShell и обращается к реестру, а при удаленном транспорте открывает доступ по сети

Коротко о 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.

Частые вопросы

Нужна ли отдельная модель компьютерного зрения?

Нет. Сервер строит дерево элементов интерфейса через UI Automation и работает с любой языковой моделью, зрение не обязательно.

Можно ли открыть доступ по сети?

Да, есть транспорты HTTP и SSE, но защиту вы настраиваете сами: ключ доступа, список разрешенных адресов, TLS и OAuth задаются флагами или переменными окружения.

Выбор редакции

MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n

MCP-серверВысокий рискБез VPN23 тыс.Звезды репозитория
Официальный

Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier

ПлагинВысокий риск421Звезды репозитория

Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio

СкиллВысокий риск75,8 тыс.Звезды репозитория

Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub

ПлагинВысокий рискБез VPN50,9 тыс.Звезды репозитория
Foxx AIWindows-MCP

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.