Skip to content

Feature Request: Support for automating Windows Server via RDP sessions #188

@ntphiep

Description

@ntphiep

Currently, Windows-MCP runs as a local MCP server on the machine being automated. This works well for local Windows desktops, but there's no clear path for managing remote Windows Server instances accessed via RDP (Remote Desktop Protocol) — a very common scenario in enterprise/cloud environments (e.g., AWS EC2, Azure VMs, on-prem servers).

Describe the solution you'd like

A few possible approaches worth discussing:

  1. Agent-side RDP session awareness — When an RDP session is active (e.g., via mstsc.exe), allow Windows-MCP to target the RDP window's virtual desktop, so Screenshot, Click, Type, etc. operate within that session.
  2. Remote deployment model — Provide a guide or tooling to install and run Windows-MCP on the remote Windows Server, then expose it over a secure tunnel (e.g., SSH port-forwarding or the existing network transport mode), so the local AI agent connects to the remote instance.
  3. First-class RDP transport — A dedicated transport that connects directly to an RDP endpoint (hostname + credentials), starts a session, and relays tool calls — similar to how some CI/CD tools drive headless RDP sessions.

Describe alternatives you've considered

  • Running Windows-MCP on the server directly and connecting via the existing --transport streamable-http mode — but this requires manual setup and isn't documented for server environments.
  • Using PowerShell remoting (WinRM) alongside Windows-MCP for the non-UI parts, and RDP only for the visual layer — but this is fragmented.

Additional context

Use cases this would unlock:

  • Automated management/testing of Windows Server (IIS, AD, SQL Server, etc.)
  • Cloud VM provisioning workflows driven by an AI agent
  • QA automation against remote staging servers without needing physical access

Is there an existing workaround or a recommended architecture for this scenario?

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions