robotjs-mcp

一个 MCP 服务器，封装 robotjs 提供跨平台桌面自动化能力，支持鼠标控制、键盘模拟和屏幕操作。

安装

方式一：全局安装（推荐）

npm install -g robotjs-mcp

然后在 MCP 配置文件中添加：

{
  "mcpServers": {
    "robotjs": {
      "command": "robotjs-mcp"
    }
  }
}

方式二：使用 npx（无需安装）

{
  "mcpServers": {
    "robotjs": {
      "command": "npx",
      "args": ["-y", "robotjs-mcp"]
    }
  }
}

各编辑器配置位置

| 编辑器 | 配置位置 | |--------|----------| | Claude Desktop | %APPDATA%\Claude\claude_desktop_config.json (Windows) / ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) | | Cursor | 设置 → MCP → 添加服务器 | | VSCode + Cline/Roo Code | 插件设置中找到 MCP 配置 |

工具列表

鼠标控制

| 工具名 | 说明 | 参数 | |--------|------|------| | mouse_move | 移动鼠标到指定坐标 | x (integer), y (integer) | | mouse_click | 在当前位置点击 | button (left/right/middle, 默认 left), double (boolean) | | mouse_drag | 从起点拖拽到终点 | fromX, fromY, toX, toY, button | | mouse_scroll | 滚动鼠标滚轮 | amount (integer), direction (up/down) | | mouse_get_pos | 获取当前鼠标坐标 | 无 |

键盘控制

| 工具名 | 说明 | 参数 | |--------|------|------| | key_tap | 按下并释放一个按键 | key (string), modifiers (string[]) | | key_toggle | 按住或释放一个按键 | key (string), down (boolean), modifiers (string[]) | | type_text | 输入一段文本 | text (string, 仅支持 ASCII) |

屏幕操作

| 工具名 | 说明 | 参数 | |--------|------|------| | get_screen_size | 获取屏幕尺寸 | 无 | | get_pixel_color | 获取指定坐标的像素颜色 | x (integer), y (integer) | | screenshot | 截取屏幕指定区域 | x, y, width, height |

系统要求

• Node.js 18+
• 支持 Windows / macOS / Linux

注意: robotjs 依赖原生模块，安装时需要编译环境。如果安装失败，请确保已安装对应平台的构建工具（如 Windows 的 windows-build-tools 或 macOS 的 Xcode Command Line Tools）。

开发

npm install
npm start

发布

# 升级 patch 版本 (1.0.0 → 1.0.1)
npm run release

# 升级 minor 版本 (1.0.0 → 1.1.0)
npm run release:minor

# 升级 major 版本 (1.0.0 → 2.0.0)
npm run release:major

License

ISC