{
  "markdown": "# Windows Computer Use MCP Server\n\n**English** | [中文](#中文)\n\nAn 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.\n\n> **Note**: This server only runs on **Windows**.\n\n## Features\n\n- **Screenshots** — Capture full screen or specific regions as base64 PNG\n- **Mouse Control** — Move, click, double-click, right-click, drag, scroll\n- **Keyboard Input** — Type text, press key combinations, hold keys\n- **Cursor Position** — Get current cursor coordinates\n- **Clipboard** — Read and write clipboard text\n- **Application Management** — List running apps, get frontmost app, open apps\n- **Display Info** — List connected displays with dimensions\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `screenshot` | Take a screenshot of the current screen |\n| `zoom` | Take a screenshot of a specific region |\n| `mouse_move` | Move the mouse cursor to coordinates |\n| `left_click` | Left-click at coordinates or current position |\n| `right_click` | Right-click at coordinates |\n| `double_click` | Double-click at coordinates |\n| `left_click_drag` | Click and drag from one point to another |\n| `scroll` | Scroll the mouse wheel |\n| `type` | Type a string of text |\n| `key` | Press a key combination (e.g. `ctrl+c`, `alt+f4`) |\n| `hold_key` | Hold a key for a duration |\n| `cursor_position` | Get current cursor position |\n| `list_running_applications` | List all running apps with visible windows |\n| `get_frontmost_application` | Get the currently focused app |\n| `open_application` | Open an app by name or path |\n| `list_displays` | List connected displays |\n| `read_clipboard` | Read clipboard text |\n| `write_clipboard` | Write text to clipboard |\n\n## Installation\n\n### Prerequisites\n\n- [Bun](https://bun.sh/) >= 1.3.11\n- Windows 10/11\n\n### Install via npm\n\n```bash\nnpm install -g windows-computer-use-mcp\n```\n\n### Install via npx (no install needed)\n\n```bash\nnpx windows-computer-use-mcp\n```\n\n### Build from source\n\n```bash\ngit clone https://github.com/hiphopanda/windows-computer-use-mcp.git\ncd windows-computer-use-mcp\nbun install\nbun run build\n```\n\n## Configuration\n\nAdd to your MCP client settings (e.g. Claude Desktop):\n\n```json\n{\n  \"mcpServers\": {\n    \"computer-use\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"windows-computer-use-mcp\"]\n    }\n  }\n}\n```\n\nOr if installed globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"computer-use\": {\n      \"type\": \"stdio\",\n      \"command\": \"windows-computer-use-mcp\"\n    }\n  }\n}\n```\n\n## Development\n\n```bash\nbun install          # Install dependencies\nbun run dev          # Run in development mode\nbun run build        # Build to dist/\nbun run start        # Run built version\n```\n\n## Architecture\n\n- **Runtime**: Bun + TypeScript\n- **Transport**: stdio (MCP protocol)\n- **Platform Layer**: All desktop operations go through PowerShell scripts executed via `Bun.spawn`\n- **Low-level Input**: Uses Win32 P/Invoke (`user32.dll`) loaded at runtime — no precompiled native modules needed\n\n## License\n\n[MIT](LICENSE)\n\n---\n\n# 中文\n\n一个基于 MCP（Model Context Protocol）协议的 Windows 桌面自动化服务器。通过 MCP 协议控制鼠标、键盘、截屏、剪贴板，以及管理应用程序。\n\n> **注意**：本服务器仅支持 **Windows** 系统。\n\n## 功能特性\n\n- **截屏** — 全屏或指定区域截图，返回 base64 PNG\n- **鼠标控制** — 移动、单击、双击、右击、拖拽、滚轮滚动\n- **键盘输入** — 输入文本、按键组合、长按按键\n- **光标位置** — 获取当前光标坐标\n- **剪贴板** — 读写剪贴板文本\n- **应用管理** — 列出运行中的应用、获取前台应用、打开应用\n- **显示器信息** — 列出已连接的显示器及分辨率\n\n## 工具列表\n\n| 工具 | 说明 |\n|------|------|\n| `screenshot` | 截取当前屏幕 |\n| `zoom` | 截取指定区域 |\n| `mouse_move` | 移动鼠标到指定坐标 |\n| `left_click` | 左键点击 |\n| `right_click` | 右键点击 |\n| `double_click` | 双击 |\n| `left_click_drag` | 左键拖拽 |\n| `scroll` | 滚动鼠标滚轮 |\n| `type` | 输入文本 |\n| `key` | 按键组合（如 `ctrl+c`、`alt+f4`） |\n| `hold_key` | 长按按键 |\n| `cursor_position` | 获取光标当前位置 |\n| `list_running_applications` | 列出所有运行中的应用 |\n| `get_frontmost_application` | 获取当前前台应用 |\n| `open_application` | 按名称或路径打开应用 |\n| `list_displays` | 列出已连接的显示器 |\n| `read_clipboard` | 读取剪贴板文本 |\n| `write_clipboard` | 写入文本到剪贴板 |\n\n## 安装\n\n### 环境要求\n\n- [Bun](https://bun.sh/) >= 1.3.11\n- Windows 10/11\n\n### 通过 npm 安装\n\n```bash\nnpm install -g windows-computer-use-mcp\n```\n\n### 通过 npx 运行（无需安装）\n\n```bash\nnpx windows-computer-use-mcp\n```\n\n### 从源码构建\n\n```bash\ngit clone https://github.com/hiphopanda/windows-computer-use-mcp.git\ncd windows-computer-use-mcp\nbun install\nbun run build\n```\n\n## 配置\n\n在 MCP 客户端配置中添加（如 Claude Desktop）：\n\n```json\n{\n  \"mcpServers\": {\n    \"computer-use\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"windows-computer-use-mcp\"]\n    }\n  }\n}\n```\n\n或全局安装后：\n\n```json\n{\n  \"mcpServers\": {\n    \"computer-use\": {\n      \"type\": \"stdio\",\n      \"command\": \"windows-computer-use-mcp\"\n    }\n  }\n}\n```\n\n## 开发\n\n```bash\nbun install          # 安装依赖\nbun run dev          # 开发模式运行\nbun run build        # 构建到 dist/\nbun run start        # 运行构建产物\n```\n\n## 架构\n\n- **运行时**：Bun + TypeScript\n- **传输层**：stdio（MCP 协议）\n- **平台层**：所有桌面操作通过 `Bun.spawn` 执行 PowerShell 脚本\n- **底层输入**：通过 Win32 P/Invoke（`user32.dll`）在运行时加载 — 无需预编译原生模块\n\n## 许可证\n\n[MIT](LICENSE)\n",
  "bytes": 5070,
  "sha": "8c5896f9bc67b7d92341c0c9a9124cddad97727c4342209c9df22f6de47abf52",
  "repo_slug": "hiphopanda/windows-computer-use-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hiphopanda_windows_computer_us_41e81d61/readme"
}