安裝
npx -y @harusame64/desktop-touch-mcp適合誰
適合要讓 Claude、Cursor 或其它 MCP 用戶端看見並操作 Windows 10/11 桌面的人。官方能力包括 screenshots、UI Automation、Chrome CDP、keyboard / mouse、terminal,並且用 semantic discover-then-act,避免 pixel-coordinate guessing。
它不是跨平台遠端桌面。本機必須是 Windows 10/11。官方還寫了 32 tools、native Rust engine(UIA in 2 ms)、zero-config PowerShell fallback、full CJK support、MIT licensed,可驅動 Notepad、Excel、Chrome、Windows Terminal 以及其它本機應用。
官方頁面:
https://github.com/Harusame64/desktop-touch-mcp
3 分鐘完成第一次嘗試
只走官方命令:
npx -y @harusame64/desktop-touch-mcp
把它加到 Claude / Cursor / VS Code Copilot 設定。不要另找未出現的安裝器。
前置條件:Windows 10/11;本機能跑 npx。第一次不要移動滑鼠去點應用,也不要開啟 Key Locker。先記住應急停止:把滑鼠停在主顯示器左上角(within 10px of 0,0)500ms。
設定位置:上述用戶端的 MCP 設定。官方沒有給出檔案路徑。
第一次呼叫必須用已點名的 desktop_discover。它回傳 interactive entities 與 short-lived leases,而不是原始座標。成功訊號:看到實體與租約,且沒有鍵盤輸入或滑鼠點擊落到視窗上。
不要馬上呼叫 desktop_act。那會 operate on what you mean;官方有 per-action perception guards,會在輸入落地前核對目標視窗 identity 和 bounds,但仍是寫操作。
唯讀發現不是零風險:它會截屏、讀 UI 樹,並可能觸及 Chrome CDP。本機桌面內容會進入用戶端。
使用案例
案例一:先發現再決定是否動手。呼叫 desktop_discover,閱讀回傳的實體與租約。官方沒有寫租約時長或實體欄位表。目前只能走到「能看見可互動物件,而不是像素點」。
案例二:對已有租約執行動作。呼叫 desktop_act。官方強調它操作的是 what,不是 where,並且有 perception guards 防止 wrong-window typing。沒有給出動作列舉。呼叫前必須能看到確認點,並準備好左上角急停。
Key Locker 是另一條已點名能力:在它自己的安全對話框裡儲存一次憑證(Windows DPAPI 加密,never shown to the assistant),再用 key_locker(action='launch_console') 開啟控制台,ssh / sudo 的隱藏提示會自動填密。第一次嘗試不要走這條。
使用邊界
平台邊界:Windows 10/11。能力邊界:已點名工具是 desktop_discover、desktop_act、key_locker;總共寫了 32 tools,但其餘名字未出現。
安全邊界:急停是主螢幕左上角 10px、500ms。憑證不給助手看,但仍存在本機。官方沒有寫遠端工作階段或非 Windows 回退。