Windows Automation MCP Server

# Windows 自动化 MCP 安装指南 ## 🚀 快速安装（推荐） ### 方法 1：使用安装脚本 ```bash # 双击运行 install.bat ``` ### 方法 2：手动安装 ```bash # 1. 进入目录 cd c:\Users\Administrator\Desktop\cursor工作盘\windows-automation-mcp # 2. 安装核心依赖 npm install --omit=optional # 3. 安装浏览器自动化（可选） npm install puppeteer ``` ## ⚙️ 配置 Cursor ### 1. 找到 MCP 配置文件 配置文件位置： ``` %APPDATA%\Cursor\User\globalStorage\mcp.json ``` 完整路径示例： ``` C:\Users\你的用户名\AppData\Roaming\Cursor\User\globalStorage\mcp.json ``` ### 2. 添加配置 如果文件不存在，创建新文件；如果已存在，添加到 `mcpServers` 对象中： ```json { "mcpServers": { "windows-automation": { "command": "node", "args": [ "c:\\Users\\Administrator\\Desktop\\cursor工作盘\\windows-automation-mcp\\src\\server.js" ] } } } ``` ⚠️ **注意**：请将路径中的 `Administrator` 替换为你的实际用户名。 ### 3. 重启 Cursor 配置完成后，完全关闭并重新启动 Cursor。 ## ✅ 验证安装 ### 测试运行 ```bash node test.js ``` ### 在 Cursor 中测试 重启 Cursor 后，在对话中输入： ``` 请帮我列出桌面上的所有文件 ``` 或者： ``` 请获取当前系统信息 ``` 如果能够正常响应，说明安装成功！ ## 📦 已安装的功能 ### ✅ 核心功能（无需额外安装） 1. **文件系统操作** - 读写文件 - 创建/删除/移动文件 - 列出目录 - 搜索文件 2. **进程管理** - 启动程序 - 结束进程 - 列出进程 - 进程信息 3. **PowerShell/CMD** - 执行命令 - 获取系统信息 - 磁盘信息 - 网络信息 4. **剪贴板** - 读取剪贴板 - 设置剪贴板 - 清空剪贴板 5. **屏幕截图** - 全屏截图 - 区域截图 6. **窗口管理** - 列出窗口 - 激活窗口 - 关闭窗口 7. **浏览器自动化** (Puppeteer) - 启动浏览器 - 网页导航 - 元素操作 - 网页截图 ### ⚠️ 可选功能（需要额外安装） #### 鼠标键盘控制 (robotjs) **要求**：需要 Visual Studio Build Tools **安装步骤**： 1. 安装 Visual Studio Build Tools： ```bash # 下载并安装 # https://visualstudio.microsoft.com/visual-cpp-build-tools/ # # 或使用 Chocolatey choco install visualstudio2022buildtools --package-parameters "--add Microsoft.VisualStudio.Workload.VCTools" ``` 2. 安装 robotjs： ```bash npm install robotjs ``` 3. 功能列表： - 移动鼠标 - 鼠标点击 - 键盘输入 - 按键模拟 ## 🔧 常见问题 ### Q1: 找不到 mcp.json 文件？ **A**: 手动创建： 1. 打开文件资源管理器 2. 输入：`%APPDATA%\Cursor\User\globalStorage` 3. 创建文件：`mcp.json` 4. 粘贴配置内容 ### Q2: Cursor 中看不到 MCP 工具？ **A**: 检查： 1. 配置文件路径是否正确 2. 是否完全重启了 Cursor 3. 路径中的反斜杠是否使用双反斜杠 `\\` ### Q3: 提示"找不到 node 命令"？ **A**: 1. 确保已安装 Node.js 2. 在配置中使用完整路径： ```json "command": "C:\\Program Files\\nodejs\\node.exe" ``` ### Q4: robotjs 安装失败？ **A**: 1. robotjs 是可选的，不影响其他功能 2. 如需安装，必须先安装 Visual Studio Build Tools 3. 或者使用 PowerShell 替代方案（已集成） ## 📚 使用示例 ### 文件操作 ``` 请读取桌面上的 test.txt 文件 请在 D:\temp 目录下创建一个文件 请列出 C:\Windows 目录下的所有文件 ``` ### 进程管理 ``` 请打开记事本 请列出所有 chrome 进程 请结束 notepad.exe 进程 ``` ### 系统信息 ``` 请获取系统信息 请查看磁盘使用情况 请获取网络配置 ``` ### 窗口管理 ``` 请列出所有打开的窗口 请激活记事本窗口 请关闭包含"Chrome"的窗口 ``` ### 屏幕和剪贴板 ``` 请截取当前屏幕 请获取剪贴板内容 请将"Hello World"复制到剪贴板 ``` ### 浏览器自动化 ``` 请启动浏览器访问 https://www.baidu.com 请在搜索框输入"hello" 请截取网页完整截图 ``` ## 🆘 获取帮助 如果遇到问题： 1. 查看 [README.md](README.md) 详细文档 2. 运行 `node test.js` 进行诊断 3. 检查 Cursor 的开发者工具控制台（如果有错误） ## 📝 更新日志 - v1.0.0 - 初始版本 - 8 大类功能模块 - 40+ 自动化工具 - 完整的 Windows 系统控制能力