windows-computer-use-mcp

Windows Computer Use MCP Server

英語 | 中文

Windows 向けのデスクトップ自動化ツールを提供する MCP（Model Context Protocol）サーバーです。マウスやキーボードの操作、スクリーンショットの撮影、クリップボードの管理、アプリケーションとのやり取りを、すべて 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          # 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
• 鼠标控制 — 移动、单击、双击、右击、拖拽、滚轮滚动
• 键盘输入 — 输入文本、按键组合、长按按键
• 光标位置 — 获取当前光标坐标
• 剪贴板 — 读写剪贴板文本
• 应用管理 — 列出运行中的应用、获取前台应用、打开应用
• 显示器信息 — 列出已连接的显示器及分辨率

工具列表

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

许可证

MIT