# WinRemote MCP — Remote Windows Control Server

> WinRemote MCP is a Windows MCP server you run on the target machine, exposing desktop automation, process control, and file operations to MCP clients.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

1. Install / set up:
   ```bash
   pip install winremote-mcp
   ```
2. Start / smoke test:
   ```bash
   winremote-mcp
   ```
3. Verify:
   - Confirm it starts on `http://127.0.0.1:8090` and then add it to your MCP client config.

## Intro

WinRemote MCP is a Windows MCP server you run on the target machine, exposing desktop automation, process control, and file operations to MCP clients.

- **Best for:** agent workflows that need Windows desktop automation as a tool (screenshots, PowerShell, files, apps)
- **Works with:** Windows machine running Python, MCP clients (Claude Desktop/Code, Cursor, etc.)
- **Setup time:** 10 minutes

## Practical Notes

- Default server URL in quickstart: `http://127.0.0.1:8090`
- Supports both local-only mode and authenticated remote binding (per README flags)
- GitHub stars/forks (verified): see Source & Thanks

Treat WinRemote as a “Windows tool adapter” for your agent:

1. Install and run it on the Windows machine you want to control.
2. Keep the default loopback-only binding for safety.
3. If you must expose it on LAN, use an auth key and avoid insecure modes on shared networks.

It pairs well with agent workflows that need a real Windows desktop for:

- UI automation that can’t run headless,
- PowerShell operations,
- file transfers and local app control.

Keep the tool boundary tight: give the agent only the minimum permissions required for the job.

### FAQ

**Q: Where does it run?**
A: On the Windows machine you want to control; clients connect over MCP.

**Q: Is it safe to expose remotely?**
A: Use authentication and avoid insecure flags on routed/shared networks.

**Q: How do I integrate with my AI tool?**
A: Add it as an MCP server in your client (Claude Desktop/Code, Cursor, etc.).

## Source & Thanks

> Source: https://github.com/dddabtc/winremote-mcp
> License: MIT
> GitHub stars: 115 · forks: 31

---

<!-- ZH -->

## 快速使用

1. 安装 / 设置：
   ```bash
   pip install winremote-mcp
   ```
2. 启动 / 冒烟测试：
   ```bash
   winremote-mcp
   ```
3. 验证：
   - 确认服务在 `http://127.0.0.1:8090` 启动，然后把它加入你的 MCP 客户端配置。

## 简介

WinRemote MCP 是运行在目标 Windows 机器上的远程控制 MCP server：通过 MCP 端点暴露桌面自动化、进程管理与文件操作等能力，便于 Claude Desktop/Code、Cursor 等客户端按需调用。

- **适合谁：** 需要把 Windows 桌面自动化当作 Agent 工具层（截图/PowerShell/文件/应用）的工作流
- **可搭配：** 安装了 Python 的 Windows 机器，以及 MCP 客户端（Claude Desktop/Code、Cursor 等）
- **准备时间：** 10 分钟

## 实战建议

- Quickstart 默认地址：`http://127.0.0.1:8090`
- 支持本地模式与带认证的远程绑定（README 提供对应参数）
- GitHub stars / forks（已核验）：见「来源与感谢」

可以把 WinRemote 理解为“Windows 工具适配层”：

1. 在要被控制的 Windows 机器上安装并运行。
2. 默认保持只绑定本机回环地址（最安全）。
3. 若必须在局域网暴露，务必设置 auth key，并避免在共享网络使用不安全模式。

它适合那些必须依赖真实 Windows 桌面的 Agent 任务：

- 不能 headless 的 UI 自动化；
- PowerShell 运维操作；
- 文件操作与本地应用控制。

建议始终收紧权限边界：只给 Agent 完成任务所必需的最小权限。

### FAQ

**它运行在哪里？**
答：运行在被控制的 Windows 机器上，AI 客户端通过 MCP 连接。

**远程暴露安全吗？**
答：请使用认证并避免在可路由/共享网络使用不安全参数。

**怎么接入 AI 工具？**
答：在客户端（Claude Desktop/Code、Cursor 等）里把它配置成 MCP server。

## 来源与感谢

> Source: https://github.com/dddabtc/winremote-mcp
> License: MIT
> GitHub stars: 115 · forks: 31


---
Source: https://tokrepo.com/en/workflows/winremote-mcp-remote-windows-control-server
Author: MCP Hub