winrdp-mcp — MCP-сервер для Claude Code: установка
MCP-сервер winrdp-mcp для Claude Code настраивает удалённое управление Windows через WinRM, SSH и SMB. Агент получает доступ к RDP, файлам, службам и GUI.
MIT ★ 7 обновлён 2026-11-07
claude mcp add --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> --transport stdio winrdp-mcp -- uvx winrdp-mcpЧто делает winrdp-mcp
winrdp-mcp подключает Windows-хосты и готовит их к удалённому администрированию. Сервер включает WinRM, открывает правила Windows Firewall и исправляет фильтрацию токенов локального администратора. Доступны команды для PowerShell, файлов, реестра, служб, процессов, задач, пользователей, журналов событий, сети и управления рабочим столом RDP.
Контроллер работает с одного сервера и может обращаться к нескольким хостам. На целевой машине ничего заранее устанавливать не нужно. Для холодного старта через SMB/WMI нужен дополнительный пакет impacket; если WinRM и SSH недоступны, provision_host выдаёт одноразовую команду для вставки в RDP-сеанс. На машине оператора нужен Python 3.10+ и пароль администратора удалённого хоста.
Какие задачи решает
- подключить Windows-хост без ручной настройки WinRM
- запустить PowerShell или Python на удалённой машине
- управлять службами, процессами и задачами Windows
- снять скриншот и выполнить действия в RDP-сеансе
- проверить состояние системы, порты и события безопасности
Примеры запросов агенту
- Подключи хост
vps1с адресом203.0.113.10и выполни его подготовку черезprovision_host. - Покажи сведения о системе и запусти PowerShell-команду для списка работающих служб.
- Открой удалённый рабочий стол, сделай скриншот и нажми нужную кнопку через UI Automation.
Как установить winrdp-mcp
Командой платформы
claude mcp add --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> --transport stdio winrdp-mcp -- uvx winrdp-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from winrdp-mcp <команда>
Командой платформы
codex mcp add winrdp-mcp --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> -- uvx winrdp-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from winrdp-mcp <команда>
Файл настроек
{
"mcpServers": {
"winrdp-mcp": {
"command": "uvx",
"args": [
"winrdp-mcp"
],
"env": {
"WINRDP_VAULT_KEY": "<WINRDP_VAULT_KEY>",
"WINRDP_PROFILE": "<WINRDP_PROFILE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from winrdp-mcp <команда>
Файл настроек
{
"servers": {
"winrdp-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"winrdp-mcp"
],
"env": {
"WINRDP_VAULT_KEY": "<WINRDP_VAULT_KEY>",
"WINRDP_PROFILE": "<WINRDP_PROFILE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from winrdp-mcp <команда>
Командой платформы
gemini mcp add -e WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> -e WINRDP_PROFILE=<WINRDP_PROFILE> winrdp-mcp uvx winrdp-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from winrdp-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о winrdp-mcp
Как установить winrdp-mcp в Claude Code?
Выполни claude mcp add winrdp-mcp -e WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> -- uvx winrdp-mcp. Ключ WINRDP_VAULT_KEY используется для шифрования сохранённых учётных данных.
Что делает winrdp-mcp?
Сервер подключает Windows-компьютеры по WinRM, SSH или SMB и даёт Claude инструменты для командной строки, файлов, служб, реестра, RDP и GUI-автоматизации. Он также умеет готовить хост к удалённому управлению.
Что нужно для работы winrdp-mcp?
На машине оператора нужен Python 3.10+ и учётные данные администратора Windows-хоста. Для холодного старта через SMB/WMI устанавливается дополнительный пакет impacket, а для хранения данных задаётся WINRDP_VAULT_KEY.