Windows-MCP
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Дает агенту прямое управление рабочим столом Windows: клики, ввод, открытие приложений и работу с файлами
- Выполняет команды PowerShell и обращается к реестру, а при удаленном транспорте открывает доступ по сети
Установка
В терминале, через 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, затем пропиши 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
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub