インストール
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 に触れることがある。本機デスクトップ内容はクライアントへ入る。
使用例
事例1:先に発見してから手を出すか決める。desktop_discover を呼び、返った実体とリースを読む。公式はリース時間も実体フィールド表も書いていない。今は「画素点ではなく、操作可能な対象が見える」まで。
事例2:既存リースに対して動作する。desktop_act を呼ぶ。公式は what を操作し where ではないと強調し、wrong-window typing を防ぐ perception guards がある。動作列挙は無い。呼ぶ前に確認点が見え、左上急停止の準備があること。
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 フォールバックを書いていない。