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
| Tool | Description |
|---|---|
screenshot | Take a screenshot of the current screen |
zoom | Take a screenshot of a specific region |
mouse_move | Move the mouse cursor to coordinates |
left_click | Left-click at coordinates or current position |
right_click | Right-click at coordinates |
double_click | Double-click at coordinates |
left_click_drag | Click and drag from one point to another |
scroll | Scroll the mouse wheel |
type | Type a string of text |
key | Press a key combination (e.g. ctrl+c, alt+f4) |
hold_key | Hold a key for a duration |
cursor_position | Get current cursor position |
list_running_applications | List all running apps with visible windows |
get_frontmost_application | Get the currently focused app |
open_application | Open an app by name or path |
list_displays | List connected displays |
read_clipboard | Read clipboard text |
write_clipboard | Write text to clipboard |
Installation
Prerequisites
- Bun >= 1.3.11
- Windows 10/11
Install via npm
npm install -g windows-computer-use-mcp
Install via npx (no install needed)
npx windows-computer-use-mcp
Build from source
git clone https://github.com/hiphopanda/windows-computer-use-mcp.git
cd windows-computer-use-mcp
bun install
bun run build
Configuration
Add to your MCP client settings (e.g. Claude Desktop):
{
"mcpServers": {
"computer-use": {
"type": "stdio",
"command": "npx",
"args": ["windows-computer-use-mcp"]
}
}
}
Or if installed globally:
{
"mcpServers": {
"computer-use": {
"type": "stdio",
"command": "windows-computer-use-mcp"
}
}
}
Development
bun install # Install dependencies
bun run dev # Run in development mode
bun 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
中文
一个基于 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 安装
npm install -g windows-computer-use-mcp
通过 npx 运行（无需安装）
npx windows-computer-use-mcp
从源码构建
git clone https://github.com/hiphopanda/windows-computer-use-mcp.git
cd windows-computer-use-mcp
bun install
bun run build
配置
在 MCP 客户端配置中添加（如 Claude Desktop）：
{
"mcpServers": {
"computer-use": {
"type": "stdio",
"command": "npx",
"args": ["windows-computer-use-mcp"]
}
}
}
或全局安装后：
{
"mcpServers": {
"computer-use": {
"type": "stdio",
"command": "windows-computer-use-mcp"
}
}
}
开发
bun install # 安装依赖
bun run dev # 开发模式运行
bun run build # 构建到 dist/
bun run start # 运行构建产物
架构
- 运行时：Bun + TypeScript
- 传输层：stdio（MCP 协议）
- 平台层：所有桌面操作通过
Bun.spawn执行 PowerShell 脚本 - 底层输入：通过 Win32 P/Invoke（
user32.dll）在运行时加载 — 无需预编译原生模块