Windows Computer Use Mcp

io.github.hiphopanda由 GitHub 帳號 hiphopanda 發布v0.1.0更新於 Oct 24, 2026

Control Windows desktop via MCP: mouse, keyboard, screenshots, clipboard, and apps.

已驗證STDIO僅桌面效率與工作流瀏覽器自動化

概覽

AI 產生的概覽

讓助理控制 Windows 桌面：移動與點擊滑鼠、輸入按鍵、截圖、讀寫剪貼簿，以及開啟或列出應用程式。

可以做什麼
透過 MCP 提供 Windows 桌面自動化工具。工具涵蓋全螢幕或指定區域截圖、滑鼠移動、左鍵/右鍵/雙擊、拖曳與滾輪捲動、輸入文字與按鍵組合、長按按鍵、取得游標位置、讀寫剪貼簿文字、列出執行中與前景應用程式、開啟應用程式，以及列出已連接的顯示器。桌面操作由 Bun 執行環境啟動 PowerShell 指令碼執行，底層輸入透過執行時載入的 Win32 user32.dll 實現。
適用情境
當助理需要直接操作 Windows 電腦時使用，例如驅動沒有 API 的圖形介面程式、填寫表單、重現點擊流程或擷取螢幕內容。僅在 Windows 10/11 上、且針對本機桌面工作階段時有用。
執行需求
僅在 Windows 10/11 上以 stdio 本機程序執行。需要 Bun >= 1.3.11，或透過 npm 或 npx 安裝/執行 npm 套件 windows-computer-use-mcp。未宣告帳號、API 金鑰、環境變數或標頭。在 MCP 用戶端設定中配置為 stdio 指令。
安裝前請注意
此伺服器可控制整個桌面：移動滑鼠、輸入按鍵、開啟應用程式，並讀寫剪貼簿文字，因此助理可能在任何取得焦點的視窗（包括敏感視窗）中操作。剪貼簿內容可能被讀取並傳送給模型。未描述任何身分驗證或權限確認，請僅在可接受這種控制的環境中啟用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Windows Computer Use Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Windows Computer Use MCP Server

English | 中文

An MCP (Model Context Protocol) server that provides desktop automation tools for Windows. Control mouse, keyboard, take screenshots, manage clipboard, and interact with applications — all through the MCP protocol.

Note: This server only runs on Windows.

Features

  • Screenshots — Capture full screen or specific regions as base64 PNG
  • Mouse Control — Move, click, double-click, right-click, drag, scroll
  • Keyboard Input — Type text, press key combinations, hold keys
  • Cursor Position — Get current cursor coordinates
  • Clipboard — Read and write clipboard text
  • Application Management — List running apps, get frontmost app, open apps
  • Display Info — List connected displays with dimensions

Tools

ToolDescription
screenshotTake a screenshot of the current screen
zoomTake a screenshot of a specific region
mouse_moveMove the mouse cursor to coordinates
left_clickLeft-click at coordinates or current position
right_clickRight-click at coordinates
double_clickDouble-click at coordinates
left_click_dragClick and drag from one point to another
scrollScroll the mouse wheel
typeType a string of text
keyPress a key combination (e.g. ctrl+c, alt+f4)
hold_keyHold a key for a duration
cursor_positionGet current cursor position
list_running_applicationsList all running apps with visible windows
get_frontmost_applicationGet the currently focused app
open_applicationOpen an app by name or path
list_displaysList connected displays
read_clipboardRead clipboard text
write_clipboardWrite text to clipboard

Installation

Prerequisites

  • Bun >= 1.3.11
  • Windows 10/11

Install via npm

bash
npm install -g windows-computer-use-mcp

Install via npx (no install needed)

bash
npx windows-computer-use-mcp

Build from source

bash
git clone https://github.com/hiphopanda/windows-computer-use-mcp.gitcd windows-computer-use-mcpbun installbun run build

Configuration

Add to your MCP client settings (e.g. Claude Desktop):

json
{  "mcpServers": {    "computer-use": {      "type": "stdio",      "command": "npx",      "args": ["windows-computer-use-mcp"]    }  }}

Or if installed globally:

json
{  "mcpServers": {    "computer-use": {      "type": "stdio",      "command": "windows-computer-use-mcp"    }  }}

Development

bash
bun install          # Install dependenciesbun run dev          # Run in development modebun run build        # Build to dist/bun run start        # Run built version

Architecture

  • Runtime: Bun + TypeScript
  • Transport: stdio (MCP protocol)
  • Platform Layer: All desktop operations go through PowerShell scripts executed via Bun.spawn
  • Low-level Input: Uses Win32 P/Invoke (user32.dll) loaded at runtime — no precompiled native modules needed

License

MIT

中文

一个基于 MCP（Model Context Protocol）协议的 Windows 桌面自动化服务器。通过 MCP 协议控制鼠标、键盘、截屏、剪贴板，以及管理应用程序。

注意：本服务器仅支持 Windows 系统。

功能特性

  • 截屏 — 全屏或指定区域截图，返回 base64 PNG
  • 鼠标控制 — 移动、单击、双击、右击、拖拽、滚轮滚动
  • 键盘输入 — 输入文本、按键组合、长按按键
  • 光标位置 — 获取当前光标坐标
  • 剪贴板 — 读写剪贴板文本
  • 应用管理 — 列出运行中的应用、获取前台应用、打开应用
  • 显示器信息 — 列出已连接的显示器及分辨率

工具列表

工具说明
screenshot截取当前屏幕
zoom截取指定区域
mouse_move移动鼠标到指定坐标
left_click左键点击
right_click右键点击
double_click双击
left_click_drag左键拖拽
scroll滚动鼠标滚轮
type输入文本
key按键组合（如 ctrl+c、alt+f4）
hold_key长按按键
cursor_position获取光标当前位置
list_running_applications列出所有运行中的应用
get_frontmost_application获取当前前台应用
open_application按名称或路径打开应用
list_displays列出已连接的显示器
read_clipboard读取剪贴板文本
write_clipboard写入文本到剪贴板

安装

环境要求

  • Bun >= 1.3.11
  • Windows 10/11

通过 npm 安装

bash
npm install -g windows-computer-use-mcp

通过 npx 运行（无需安装）

bash
npx windows-computer-use-mcp

从源码构建

bash
git clone https://github.com/hiphopanda/windows-computer-use-mcp.gitcd windows-computer-use-mcpbun installbun run build

配置

在 MCP 客户端配置中添加（如 Claude Desktop）：

json
{  "mcpServers": {    "computer-use": {      "type": "stdio",      "command": "npx",      "args": ["windows-computer-use-mcp"]    }  }}

或全局安装后：

json
{  "mcpServers": {    "computer-use": {      "type": "stdio",      "command": "windows-computer-use-mcp"    }  }}

开发

bash
bun install          # 安装依赖bun run dev          # 开发模式运行bun run build        # 构建到 dist/bun run start        # 运行构建产物

架构

  • 运行时：Bun + TypeScript
  • 传输层：stdio（MCP 协议）
  • 平台层：所有桌面操作通过 Bun.spawn 执行 PowerShell 脚本
  • 底层输入：通过 Win32 P/Invoke（user32.dll）在运行时加载 — 无需预编译原生模块

许可证

MIT

來源：README.md，提交 e22aac2

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。