Windows Computer Use MCP Server

English | 中文

Windows용 데스크톱 자동화 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. MCP 프로토콜을 통해 마우스, 키보드 제어, 스크린샷, 클립보드 관리, 애플리케이션 상호 작용을 모두 수행할 수 있습니다.

참고: 이 서버는 Windows에서만 실행됩니다.

기능

• 스크린샷 — 전체 화면 또는 특정 영역을 base64 PNG로 캡처

• 마우스 제어 — 이동, 클릭, 더블클릭, 우클릭, 드래그, 스크롤

• 키보드 입력 — 텍스트 입력, 키 조합 누르기, 키 길게 누르기

• 커서 위치 — 현재 커서 좌표 가져오기

• 클립보드 — 클립보드 텍스트 읽기 및 쓰기

• 애플리케이션 관리 — 실행 중인 앱 나열, 전면 앱 가져오기, 앱 열기

• 디스플레이 정보 — 연결된 디스플레이와 크기 나열

Related MCP server: desktop-touch-mcp

도구

설치

사전 요구 사항

• 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          # Install dependencies
bun run dev          # Run in development mode
bun run build        # Build to dist/
bun run start        # Run built version

아키텍처

• 런타임: Bun + TypeScript

• 전송: stdio (MCP 프로토콜)

• 플랫폼 계층: 모든 데스크톱 작업은 Bun.spawn을 통해 실행되는 PowerShell 스크립트로 처리됩니다

• 저수준 입력: 런타임에 로드되는 Win32 P/Invoke(user32.dll) 사용 — 사전 컴파일된 네이티브 모듈 불필요

라이선스

MIT

中文

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

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

功能特性

• 截屏 — 全屏或指定区域截图，返回 base64 PNG

• 鼠标控制 — 移动、单击、双击、右击、拖拽、滚轮滚动

• 键盘输入 — 输入文本、按键组合、长按按键

• 光标位置 — 获取当前光标坐标

• 剪贴板 — 读写剪贴板文本

• 应用管理 — 列出运行中的应用、获取前台应用、打开应用

• 显示器信息 — 列出已连接的显示器及分辨率

工具列表

安装

环境要求

• 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）在运行时加载 — 无需预编译原生模块

许可证

MIT