# winrdp-mcp

MCP-сервер winrdp-mcp для Claude Code настраивает удалённое управление Windows через WinRM, SSH и SMB. Агент получает доступ к RDP, файлам, службам и GUI.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 у репозитория
- Автор: emog33k
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/emog33k/winrdp-mcp
- Обновлён: 2026-11-07
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/winrdp-mcp

## Что делает

winrdp-mcp подключает Windows-хосты и готовит их к удалённому администрированию. Сервер включает WinRM, открывает правила Windows Firewall и исправляет фильтрацию токенов локального администратора. Доступны команды для PowerShell, файлов, реестра, служб, процессов, задач, пользователей, журналов событий, сети и управления рабочим столом RDP.

Контроллер работает с одного сервера и может обращаться к нескольким хостам. На целевой машине ничего заранее устанавливать не нужно. Для холодного старта через SMB/WMI нужен дополнительный пакет `impacket`; если WinRM и SSH недоступны, `provision_host` выдаёт одноразовую команду для вставки в RDP-сеанс. На машине оператора нужен Python 3.10+ и пароль администратора удалённого хоста.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `WINRDP_VAULT_KEY`, `WINRDP_PROFILE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- подключить Windows-хост без ручной настройки WinRM
- запустить PowerShell или Python на удалённой машине
- управлять службами, процессами и задачами Windows
- снять скриншот и выполнить действия в RDP-сеансе
- проверить состояние системы, порты и события безопасности

## Примеры запросов агенту
- Подключи хост `vps1` с адресом `203.0.113.10` и выполни его подготовку через `provision_host`.
- Покажи сведения о системе и запусти PowerShell-команду для списка работающих служб.
- Открой удалённый рабочий стол, сделай скриншот и нажми нужную кнопку через UI Automation.

## Похожие
- [Context7](https://affpapa.org/nevibecode/mcp/context7.md) — MCP-сервер · 5563 установки
- [Search Google Flights](https://affpapa.org/nevibecode/mcp/search-google-flights.md) — MCP-сервер · 2595 установок
- [Math-MCP](https://affpapa.org/nevibecode/mcp/math-mcp.md) — MCP-сервер · 5958 установок
- [pipeworx gateway](https://affpapa.org/nevibecode/mcp/pipeworx-gateway.md) — MCP-сервер · 419019 установок
- [SparkForge](https://affpapa.org/nevibecode/mcp/sparkforge.md) — MCP-сервер · 219896 установок
- [OpenWebSearch](https://affpapa.org/nevibecode/mcp/openwebsearch.md) — MCP-сервер · 494 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
