Windows MCP

Name: Windows MCP MCP Server
Author: CursorTouch

为什么要用

核心特性

UI Automation 树访问——结构化，不依赖像素
截图、点击、输入、组合键
窗口枚举与焦点管理
进程启动与退出
剪贴板读写
支持 Windows 10/11；大多数应用不需要管理员权限

实时演示

实际使用效果

windows-mcp-cursortouch.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "windows-mcp-cursortouch": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "windows-mcp-cursortouch",
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "windows-mcp-cursortouch": {
      "command": {
        "path": "uvx",
        "args": [
          "windows-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add windows-mcp-cursortouch -- uvx windows-mcp

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： Windows MCP

自动化没有 API 的 Windows-only 业务系统

👤 厌倦了 UiPath 授权费的 RPA 工程师 ⏱ ~60 min advanced

何时使用： 内部应用供应商不提供 API，你需要 Claude 每日自动录入数据。

前置条件

装有目标应用的 Windows 10/11 — 标准安装
用于 uvx 的 Python 3.10+ — winget install Python.Python.3.12

步骤

检查 UI 树

启动应用 BookingSystem.exe，然后输出主窗口的 UI 树，我想看到 AutomationID。✓ 已复制

→ 树中显示带有 AutomationId 的控件——不只是无名按钮
跑通一次完整流程

现在：打开新建预订对话框，填写客户「Acme Inc」、日期 2026-05-12，保存。最后截图。✓ 已复制

→ 预订已保存；截图确认
泛化并循环

读取 /work/bookings.csv，对每一行重复预订流程，将截图保存到 /work/runs/。✓ 已复制

→ 每行均已处理；每次预订对应一张截图

结果： 从 CSV 驱动的无头自动化，可重复执行。

注意事项

应用使用自定义控件（如无 AutomationId 的 WinForms ListView） — 退而使用固定窗口坐标点击；记录此脆弱性
循环中途弹出模态对话框抢走焦点 — 每次 send_keys 前先检查当前活动窗口；遇到意外时中止

搭配使用： filesystem

在无法使用 Excel API 时从 Excel 提取数据

👤 IT 不允许启用 COM/Office API 的分析师 ⏱ ~15 min intermediate

何时使用： 你能打开 Excel，但无法通过编程方式访问。

步骤

打开文件

启动 Excel，打开 C:\reports\Q2.xlsx，切换到「Sales」工作表。✓ 已复制

→ 窗口标题显示文件名
复制区域

选中 A1:D200，复制到剪贴板，然后读取剪贴板文本。✓ 已复制

→ 返回以 Tab 分隔的表格数据
通过 filesystem 保存为 CSV

将数据解析成行并保存到 /tmp/Q2-sales.csv。✓ 已复制

→ CSV 文件已创建

结果： 无需 COM API 或第三方包，即可将 Excel 数据转为 CSV。

注意事项

不同 Excel 版本的剪贴板格式有差异 — 先尝试 CSV；若不行，用剪贴板变体回退到 TSV

搭配使用： filesystem

在专注工作时为同事捕获桌面 bug

👤 兼顾支持工作的开发者 ⏱ ~5 min beginner

何时使用： bug 在你的 Windows 机器上可以复现，你想留下干净的截图和复现步骤。

步骤

复现并截图

截取当前活动应用窗口，保存为 bug.png。✓ 已复制

→ PNG 已写入
整理步骤

列出你最近操作过的 5 个用户可见 UI 元素——窗口标题、对话框标签——我可以直接粘贴到 ticket 里。✓ 已复制

→ 基于元素的具体复现步骤

结果： 范围明确的 bug ticket，无需来回切换窗口。

注意事项

截图包含私密信息 — 只截取活动窗口，不截整个桌面

搭配使用： github

组合

与其他 MCP 搭配，撬动十倍杠杆

windows-mcp-cursortouch + filesystem

从 CSV 输入驱动桌面应用

读取 /work/orders.csv，对每一行在预订应用中点击完成流程。✓ 已复制

windows-mcp-cursortouch + github

捕获桌面 bug 并创建 issue

截取活动窗口截图，然后创建 GitHub issue，附上 PNG 和复现步骤。✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
list_windows	（无）	找到目标应用	免费
get_ui_tree	window_id?	点击前的探索阶段	免费
click	automation_id \| x,y	点击已知控件	免费
type_text	text: str	在焦点字段中输入文本	免费
send_keys	keys: str（如 'ctrl+s'）	快捷键/组合键	免费
screenshot	window_id?, region?	视觉确认	免费
launch_process	exe: str	启动目标应用	免费
read_clipboard	（无）	复制操作后读取	免费

成本与限制

运行它的成本

API 配额: 无——本地自动化
每次调用 Token 数: 50–500（UI 树转储可能更大）
费用: 开源免费
提示: 不要每步都转储完整 UI 树——通过 window_id 缩小范围

安全

权限、密钥、影响范围

最小权限： 控制本地桌面会话

凭据存储： 无——但 Claude 能看到屏幕上显示的一切

数据出站： 本地；除非你同时授权了网络 MCP，否则不会有数据离开机器

切勿授予： 管理员账户自动启动 远程访问配对

不要在浏览器 tab 中打开了敏感凭证的开发机上运行——截图可能捕获到这些信息
发出点击前始终预览 UI 树；在执行 send_keys 前验证目标窗口

故障排查

常见错误与修复

通过 automation_id 找不到控件

应用使用了动态 ID 或没有 ID。用 get_ui_tree 按 name/role 层级匹配

验证： 用 Microsoft inspect.exe 检查

点击落在了错误的窗口上

点击前始终对目标窗口调用 set_focus；点击后检查当前活动窗口

uvx 安装失败，报 'wheel' 错误

安装 Visual C++ Build Tools；部分 pywin32 依赖需要

替代方案

Windows MCP 对比其他方案

替代方案	何时用它替代	权衡
Anthropic Computer Use（像素模式）	需要跨平台的像素级控制	在 Windows 上不如 UIA 可靠；对布局变化更脆弱
AutoIt / PowerShell	在 LLM 之外编写脚本	无 agent 层；只能手动编写脚本
Peekaboo（macOS）	你在 macOS 上，不是 Windows	不同操作系统；不可互换

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： Windows MCP

自动化没有 API 的 Windows-only 业务系统

前置条件

步骤

注意事项

在无法使用 Excel API 时从 Excel 提取数据

步骤

注意事项

在专注工作时为同事捕获桌面 bug

步骤

注意事项

组合

与其他 MCP 搭配，撬动十倍杠杆

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

Windows MCP 对比其他方案

更多

资源