Windows Computer Use Mcp

io.github.hiphopandaPublished by GitHub account hiphopandav0.1.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowBrowser Automation

Overview

AI-generated overview

Lets an assistant control a Windows desktop: move and click the mouse, type keys, take screenshots, read and write the clipboard, and open or list applications.

What you can do
Provides desktop automation tools for Windows over MCP. Tools cover screenshots of the full screen or a region, mouse movement, left/right/double click, drag and scroll, typing text and key combinations, holding keys, reading cursor position, reading and writing clipboard text, listing running and frontmost applications, opening applications, and listing connected displays. Desktop operations run through PowerShell scripts spawned by the Bun runtime, with low-level input via Win32 user32.dll loaded at runtime.
When to use it
Use it when an assistant needs to operate a Windows machine directly, for example to drive a GUI application that has no API, fill in forms, reproduce a click path, or capture what is on screen. It is only useful on Windows 10/11 and only for local desktop sessions.
Requirements
Runs locally as a stdio process on Windows 10/11 only. Requires Bun >= 1.3.11, or install/run the npm package windows-computer-use-mcp via npm or npx. No accounts, API keys, environment variables or headers are declared. Configure it in the MCP client settings as a stdio command.
Before you install
The server can control the whole desktop: it moves the mouse, types keys, opens applications, and reads and writes clipboard text, so an assistant could act in any focused window, including sensitive ones. Clipboard contents may be read and sent to the model. There is no authentication or permission prompt described, so grant it only where such control is acceptable.

Installation

In SourceWeft

  1. Open Windows Computer Use Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit e22aac2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.