# winrdp-mcp

winrdp-mcp is an MCP server for Claude Code that prepares and manages Windows hosts over WinRM, SSH, and SMB. It exposes RDP, file, service, and GUI controls.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: emog33k
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/emog33k/winrdp-mcp
- Updated: 2026-11-07
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/winrdp-mcp

## What it does

winrdp-mcp connects Windows machines and makes them manageable remotely. It can enable WinRM, adjust Windows Firewall rules, and handle local administrator token filtering. Its tools cover PowerShell, files, the registry, services, processes, scheduled tasks, users, event logs, networking, and interactive RDP desktop actions.

The controller can work with several hosts from one server, and the target does not need a preinstalled agent. Cold-start access through SMB/WMI requires the extra `impacket` package; when WinRM and SSH are unavailable, `provision_host` returns a one-time command for an RDP session. The operator machine needs Python 3.10+ and administrator credentials for the remote host.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `WINRDP_VAULT_KEY`, `WINRDP_PROFILE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> --transport stdio winrdp-mcp -- uvx winrdp-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add winrdp-mcp --env WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> --env WINRDP_PROFILE=<WINRDP_PROFILE> -- uvx winrdp-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "winrdp-mcp": {
            "command": "uvx",
            "args": [
                "winrdp-mcp"
            ],
            "env": {
                "WINRDP_VAULT_KEY": "<WINRDP_VAULT_KEY>",
                "WINRDP_PROFILE": "<WINRDP_PROFILE>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>

### GitHub Copilot

**Config file**
File `.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>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WINRDP_VAULT_KEY=<WINRDP_VAULT_KEY> -e WINRDP_PROFILE=<WINRDP_PROFILE> winrdp-mcp uvx winrdp-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from winrdp-mcp <command>

## When to use it
- prepare a Windows host for remote administration
- run PowerShell or Python on a remote machine
- inspect and control Windows services, processes, and tasks
- take screenshots and operate an interactive RDP desktop
- check system health, open ports, and security events

## Example prompts
- Add the host `vps1` at `203.0.113.10`, then ask the server to prepare it with `provision_host`.
- Show the system details and run a PowerShell command that lists active services.
- Open the remote desktop, capture a screenshot, and click a named control through UI Automation.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
