# Windows-MCP — Windows Computer-Use MCP

> Windows-MCP is a Python MCP server for Windows 7–11 that lets agents control apps, UI, and files. Install from PyPI via uvx and add to Claude Code.

## Install

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

# Windows-MCP — Windows Computer-Use MCP

> Windows-MCP is a Python MCP server for Windows 7–11 that lets agents control apps, UI, and files. Install from PyPI via uvx and add to Claude Code.

## Quick Use

1) Install

```bash
pip install uv && claude mcp add --transport stdio windows-mcp -- uvx windows-mcp
```

2) Run

```bash
uvx windows-mcp
```

3) Verify

```bash
In your MCP client: confirm Windows-MCP tools show up
```

---

## Intro

**Best for**: teams who need real Windows automation (QA, app control, file ops) through an MCP server instead of fragile scripts

**Works with**: Windows 7–11, Python 3.13+ per repo, uv/uvx, MCP clients (Claude Code/Cursor and more)

**Setup time**: 12 minutes

### Quant Data

- Windows 7–11 support (repo)
- Python 3.13+ (repo)

---

## How to Use It Well

Adopt Windows-MCP by scoping permissions first (folders, apps). Start with file navigation, then UI actions, then QA flows with deterministic assertions.

### Adoption Checklist

- Start with one real task and keep the scope narrow
- Capture a baseline: time-to-first-success and output quality
- Version your config/skills so teammates stay in sync

### Guardrails

Computer-use tools are powerful; require human approval for destructive actions and keep audit logs for every run.

### FAQ

**Q: Is this only for Claude Desktop?**
A: No. The repo lists multiple clients (Claude Code, Cursor, Codex, Gemini CLI, Qwen Code). Any MCP client that can run the command works.

**Q: Why `uvx`?**
A: The repo recommends uv/uvx to run the latest package from PyPI and keep PATH handling predictable.

**Q: How do I debug connection issues?**
A: On Windows sandboxed apps may not inherit PATH; the repo suggests using the full absolute path to `uvx.exe`.

---

## Source & Thanks

> GitHub: https://github.com/CursorTouch/Windows-MCP
> Owner avatar: https://avatars.githubusercontent.com/u/201312842?v=4
> License (SPDX): MIT
> GitHub stars (verified via `api.github.com/repos/CursorTouch/Windows-MCP`): 5,536


---

<!-- ZH -->

# Windows-MCP——Windows 电脑操作 MCP

> Windows-MCP 是面向 Windows 7–11 的 Python MCP server，支持文件/应用/界面控制与自动化测试。用 uvx 从 PyPI 启动，再接入 Claude Code/Cursor。

## 快速使用

1）安装

```bash
pip install uv && claude mcp add --transport stdio windows-mcp -- uvx windows-mcp
```

2）运行

```bash
uvx windows-mcp
```

3）验证

```bash
In your MCP client: confirm Windows-MCP tools show up
```

---

## 简介

**适合谁**：需要真实 Windows 自动化（QA、应用控制、文件操作）的团队，希望用 MCP server 替代脆弱脚本

**适用环境**：Windows 7–11、仓库标注 Python 3.13+、uv/uvx、支持 MCP 的客户端（Claude Code/Cursor 等）

**安装耗时**：12 分钟

### 量化信息

- 支持 Windows 7–11（仓库）
- 要求 Python 3.13+（仓库）

---

## 用好它的方式

接入 Windows-MCP 时先做权限收敛（目录/应用）。先从文件导航开始，再到 UI 操作，最后用可断言的方式跑 QA 流程。

### 推广清单

- 先选一个真实任务，小范围试跑
- 记录基线：首次成功耗时与输出质量
- 配置/技能要版本化，避免团队漂移

### 风险与护栏

电脑操作类工具能力很强；对破坏性动作强制人工确认，并为每次运行保留审计日志。

### FAQ

**Q: 只能给 Claude Desktop 用吗？**
A: 不是。仓库列出多个客户端（Claude Code、Cursor、Codex、Gemini CLI、Qwen Code 等）；只要能运行该命令的 MCP 客户端都能用。

**Q: 为什么推荐 `uvx`？**
A: 仓库推荐用 uv/uvx 直接从 PyPI 运行最新版，并把 PATH 行为固定下来，减少环境差异。

**Q: 连接报错怎么排查？**
A: Windows 的沙盒应用可能不继承 PATH；仓库建议用 `uvx.exe` 的绝对路径来配置。

---

## 来源与感谢

> GitHub：https://github.com/CursorTouch/Windows-MCP
> Owner avatar：https://avatars.githubusercontent.com/u/201312842?v=4
> 许可证（SPDX）：MIT
> GitHub stars（已通过 `api.github.com/repos/CursorTouch/Windows-MCP` 核验）：5,536


---
Source: https://tokrepo.com/en/workflows/windows-mcp-windows-computer-use-mcp
Author: MCP Hub