Windows Automation MCP Server

╔════════════════════════════════════════════════════════════════╗ ║ ║ ║ 🎉 Windows 完全自动化 MCP 安装完成！ ║ ║ ║ ╚════════════════════════════════════════════════════════════════╝ ✅ 已完成的工作 ════════════════════════════════════════════════════════════════ 1. ✅ 创建完整的 MCP 服务器 - 8 大功能模块 - 40+ 自动化工具 - 模块化架构设计 2. ✅ 安装核心依赖 - @modelcontextprotocol/sdk - puppeteer（浏览器自动化） - 所有基础功能已就绪 3. ✅ 功能测试通过 - PowerShell ✓ - 文件系统 ✓ - 进程管理 ✓ - 剪贴板 ✓ 4. ✅ 创建完整文档 - 安装指南 - 配置说明 - 使用示例 - 快速开始 ════════════════════════════════════════════════════════════════ 📋 您现在拥有的功能 ════════════════════════════════════════════════════════════════ 🗂️ 文件系统（8 个工具） - 读写、创建、删除、复制、移动文件 - 列出目录、搜索文件 ⚙️ 进程管理（4 个工具） - 启动程序、结束进程 - 列出进程、获取进程信息 🪟 窗口管理（6 个工具） - 列出窗口、激活窗口 - 关闭窗口、最小化/最大化 📸 屏幕截图（2 个工具） - 全屏截图 - 区域截图 📋 剪贴板（3 个工具） - 读取、设置、清空剪贴板 💻 PowerShell/CMD（5 个工具） - 执行命令 - 获取系统/磁盘/网络信息 🌐 浏览器自动化（7 个工具） - 启动浏览器、导航网页 - 操作元素、截图 ⌨️ 鼠标键盘（6 个工具）- 需要额外安装 - 需要 Visual Studio Build Tools - 安装后可用鼠标键盘控制 ════════════════════════════════════════════════════════════════ 🚀 下一步：配置 Cursor ════════════════════════════════════════════════════════════════ 步骤很简单，只需 3 步： 1️⃣ 找到配置文件 ───────────────────────────────────────────────── 位置：%APPDATA%\Cursor\User\globalStorage\mcp.json 快捷方式： - 按 Win + R - 输入：%APPDATA%\Cursor\User\globalStorage - 创建或编辑 mcp.json 文件 2️⃣ 添加配置 ───────────────────────────────────────────────── 打开：cursor-mcp-config.json 复制内容到 mcp.json 或参考：配置Cursor.md（详细说明） 3️⃣ 重启 Cursor ───────────────────────────────────────────────── ⚠️ 必须完全退出并重新启动 不是刷新窗口，是完全关闭后重启 ════════════════════════════════════════════════════════════════ ✨ 测试是否成功 ════════════════════════════════════════════════════════════════ 配置完成后，在 Cursor 中试试这些命令： "请列出我桌面上的所有文件" "请获取当前系统信息" "请截取当前屏幕" "请将 Hello World 复制到剪贴板" 如果能正常执行，恭喜！安装成功！🎉 ════════════════════════════════════════════════════════════════ 📚 重要文档（请务必查看） ════════════════════════════════════════════════════════════════ ┌────────────────────────────────────────────────────────────┐ │ 📖 快速开始.txt - 最简洁的入门指南（推荐先看这个） │ │ 📘 配置Cursor.md - 详细的配置步骤说明 │ │ 📕 使用示例.md - 丰富的使用案例和技巧 │ │ 📗 README.md - 完整的功能列表和说明 │ │ 📙 INSTALL.md - 详细的安装和故障排除 │ └────────────────────────────────────────────────────────────┘ ════════════════════════════════════════════════════════════════ 💡 使用示例预览 ════════════════════════════════════════════════════════════════ 文件操作： "请读取桌面上的 readme.txt 文件" "请在 D:\Projects 创建一个新目录" "请复制所有 .pdf 文件到备份文件夹" 进程管理： "请打开记事本" "请列出所有 chrome 进程" "请结束卡住的程序" 系统操作： "请查看磁盘使用情况" "请获取网络配置" "请截取当前屏幕" 自动化任务： "请帮我整理桌面文件： 1. 列出所有文件 2. 按类型分类 3. 移动到对应文件夹" 更多示例请查看：使用示例.md ════════════════════════════════════════════════════════════════ ⚠️ 注意事项 ════════════════════════════════════════════════════════════════ 1. 路径格式 ✅ 正确：c:\\Users\\...（双反斜杠） ❌ 错误：c:\Users\...（单反斜杠） 2. 权限问题 某些操作可能需要管理员权限 3. 安全提醒 PowerShell/CMD 执行命令请谨慎使用 4. 鼠标键盘功能 需要额外安装 Visual Studio Build Tools 和 robotjs ════════════════════════════════════════════════════════════════ 🔧 故障排除 ════════════════════════════════════════════════════════════════ 问题：Cursor 中看不到 MCP 工具？ 解决： 1. 检查配置文件路径是否正确 2. 确认是否完全重启了 Cursor 3. 查看路径中是否使用双反斜杠 问题：提示找不到 node 命令？ 解决： 1. 确保安装了 Node.js 2. 或在配置中使用完整路径： "command": "C:\\Program Files\\nodejs\\node.exe" 问题：某些功能不工作？ 解决： 1. 运行：node test.js 进行诊断 2. 查看 Cursor 开发者工具（Ctrl+Shift+I） 3. 查看 INSTALL.md 的故障排除章节 ════════════════════════════════════════════════════════════════ 📁 项目结构 ════════════════════════════════════════════════════════════════ windows-automation-mcp/ ├── src/ │ ├── server.js # MCP 服务器主程序 │ └── tools/ # 工具模块 │ ├── filesystem.js # 文件系统 │ ├── process.js # 进程管理 │ ├── window.js # 窗口管理 │ ├── screen.js # 屏幕截图 │ ├── clipboard.js # 剪贴板 │ ├── powershell.js # PowerShell/CMD │ ├── browser.js # 浏览器自动化 │ └── mouse-keyboard.js # 鼠标键盘 ├── package.json # 依赖配置 ├── cursor-mcp-config.json # Cursor 配置模板 ├── test.js # 功能测试脚本 └── 文档/ ├── 快速开始.txt # 快速入门 ├── 配置Cursor.md # 配置说明 ├── 使用示例.md # 使用案例 ├── README.md # 功能说明 └── INSTALL.md # 安装指南 ════════════════════════════════════════════════════════════════ 🎯 立即开始 ════════════════════════════════════════════════════════════════ 1. 阅读：快速开始.txt 2. 配置：参考配置Cursor.md 3. 测试：在 Cursor 中试试上面的命令 4. 学习：查看使用示例.md ════════════════════════════════════════════════════════════════ 🎉 恭喜！您现在拥有了一个功能强大的 Windows 自动化助手！ 用自然语言控制整个 Windows 系统，享受前所未有的效率提升！ 祝使用愉快！😊 ════════════════════════════════════════════════════════════════