/ 目錄 / 演練場 / Windows MCP
● 社群 CursorTouch ⚡ 即開即用

Windows MCP

作者 CursorTouch · CursorTouch/Windows-MCP

Windows 的電腦控制方案 — Claude 讀取 UI Automation 樹狀結構(而非單純像素),因此可以可靠地操控 Excel、Outlook 及舊式企業應用程式。

Windows MCP 將 Windows UI Automation API 以及截圖與輸入合成功能暴露為 MCP 工具。與純像素的電腦控制不同,它提供 Claude 結構化的桌面樹狀檢視 — 視窗、控制項、名稱、automation ID — 即使佈局改變,點擊依然能落在正確的控制項上。專為自動化那些沒有 API 的內部 Windows 軟體而設計。

為什麼要用

核心特性

即時演示

實際使用效果

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 企業應用程式

👤 厭倦 UiPath 授權費的 RPA 工程師 ⏱ ~60 min advanced

何時使用: 內部應用程式廠商不提供 API;你需要 Claude 每天輸入資料。

前置條件
  • 已安裝目標應用程式的 Windows 10/11 — 標準安裝
  • Python 3.10+ 用於 uvx — winget install Python.Python.3.12
步驟
  1. 檢視 UI 樹狀結構
    啟動應用程式 BookingSystem.exe,然後傾印主視窗的 UI 樹狀結構。我想看到 automation ID。✓ 已複製
    → 樹狀結構顯示帶有 AutomationId 的控制項 — 不只是無名稱的按鈕
  2. 驅動一次完整流程
    現在:開啟「新增預訂」對話框,填入客戶「Acme Inc」、日期 2026-05-12,儲存。最後截圖。✓ 已複製
    → 預訂已儲存;截圖確認
  3. 泛化並迴圈執行
    讀取 /work/bookings.csv。針對每一行,重複預訂流程。將截圖存入 /work/runs/。✓ 已複製
    → 每行都已處理;每筆預訂各有截圖

結果: 廠商應用程式的無頭自動化,可從 CSV 重複執行。

注意事項
  • 應用程式使用自訂控制項(例如沒有 AutomationId 的 WinForms ListView) — 退而使用固定視窗位置的座標點擊;記錄其脆弱性
  • 迴圈執行中途有強制對話框搶走焦點 — 在 send_keys 之前務必檢查當前啟動視窗;如遇意外則中止
搭配使用: filesystem

不使用 Excel API 即可提取資料

👤 IT 不允許啟用 COM/Office API 的分析師 ⏱ ~15 min intermediate

何時使用: 你可以開啟 Excel,但無法以程式化方式操作。

步驟
  1. 開啟檔案
    啟動 Excel,開啟 C:\reports\Q2.xlsx,切換至「Sales」工作表。✓ 已複製
    → 視窗標題顯示檔案名稱
  2. 複製範圍
    選取 A1:D200,複製到剪貼簿,然後讀取剪貼簿文字。✓ 已複製
    → 回傳以 Tab 分隔的表格
  3. 透過 filesystem 另存為 CSV
    將其解析為行並儲存到 /tmp/Q2-sales.csv。✓ 已複製
    → CSV 已建立

結果: 取得 Excel 資料的 CSV 格式,無需使用 COM API 或安裝第三方套件。

注意事項
  • 剪貼簿格式因 Excel 版本而異 — 先嘗試 CSV;若失敗改用剪貼簿變體的 TSV
搭配使用: filesystem

在你專心工作時為同事擷取桌面 bug

👤 同時兼顧開發與支援的開發人員 ⏱ ~5 min beginner

何時使用: 某個不穩定的 bug 在你的 Windows 機器上重現了,你想要一張清晰的截圖加上重現步驟。

步驟
  1. 重現並擷取
    截取當前應用程式視窗的截圖。另存為 bug.png。✓ 已複製
    → PNG 已寫入
  2. 標注步驟
    列出你最後互動的 5 個使用者可見 UI 元素 — 視窗標題、對話框標籤 — 讓我可以貼到工單裡。✓ 已複製
    → 具體的元素層級重現步驟

結果: 範圍精確的 bug 工單,無需切換視窗。

注意事項
  • 截圖包含私人資訊 — 只擷取當前啟動視窗,而非整個桌面
搭配使用: github

組合

與其他 MCP 搭配,撬動十倍槓桿

windows-mcp-cursortouch + filesystem

從 CSV 輸入驅動桌面應用程式

讀取 /work/orders.csv。針對每一行,點擊完成預訂應用程式的流程。✓ 已複製
windows-mcp-cursortouch + github

擷取桌面 bug 並開立 issue

截取當前視窗截圖,然後建立包含 PNG 和重現步驟的 GitHub issue。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list_windows (none) 尋找目標應用程式 free
get_ui_tree window_id? 點擊前先探索 free
click automation_id | x,y 點擊已知控制項 free
type_text text: str 在已聚焦的欄位輸入文字 free
send_keys keys: str (e.g. 'ctrl+s') 快捷鍵/組合鍵 free
screenshot window_id?, region? 視覺確認 free
launch_process exe: str 啟動目標應用程式 free
read_clipboard (none) 複製後讀取 free

成本與限制

運行它的成本

API 配額
無 — 本機自動化
每次呼叫 Token 數
50–500(UI 樹狀傾印可能較大)
費用
免費開源
提示
避免每個步驟都傾印完整 UI 樹狀結構 — 用 window_id 縮小範圍

安全

權限、密鑰、影響範圍

最小權限: 控制本機桌面工作階段
憑證儲存: 無 — 但 Claude 可以看到螢幕上的所有內容
資料出站: 本機;除非你同時授予網路 MCP,否則不離開機器
切勿授予: 管理員帳號自動啟動 遠端存取配對

故障排查

常見錯誤與修復

找不到 automation_id 的控制項

應用程式使用動態 ID 或無 ID。使用 get_ui_tree 並依名稱/角色層次比對

驗證: 使用 Microsoft inspect.exe 檢查
點擊落在錯誤視窗

點擊前務必對目標視窗呼叫 set_focus;點擊後確認當前啟動視窗

uvx 安裝失敗,顯示 'wheel' 錯誤

安裝 Visual C++ Build Tools;部分 pywin32 相依需要它

替代方案

Windows MCP 對比其他方案

替代方案何時用它替代權衡
Anthropic Computer Use(像素)你需要跨平台的像素控制在 Windows 上比 UIA 方式不可靠;對佈局變化更脆弱
AutoIt / PowerShell在 LLM 之外進行腳本化無代理層;只能手動編寫腳本
Peekaboo(macOS)你在 macOS,不是 Windows不同作業系統;不可互換

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills