适合谁
- 需要在 Windows 上进行 UI 自动化的开发者和 QA 工程师
- 希望将 AI 代理与桌面应用程序集成的人员
- 需要执行文件和注册表操作的系统管理员
W
47FMRS · D
Windows-MCP 是连接 AI 代理与 Windows 系统的强大工具，提供了全面的 UI 自动化工具集。其轻量级设计和广泛兼容性使其易于集成。然而，由于具有系统级权限，需谨慎配置安全措施，特别是远程访问时。总体而言，对于需要 Windows 自动化的用户，它是一个可靠的选择。
Windows-MCP 是一个轻量级、开源的 MCP 服务器，它在 AI 代理和 Windows 操作系统之间架起桥梁，使代理能够执行文件导航、应用程序控制、UI 交互、QA 测试等任务。它支持 Windows 7 到 11。它提供丰富的工具集，用于 UI 自动化，包括模拟键盘鼠标操作、捕获窗口/UI 状态，以及访问 PowerShell、文件系统、注册表等。该服务器基于 MIT 许可证发布。
工具能力
Click
在给定坐标处点击屏幕。
Type
在元素上输入文本（可选择清除现有文本）。
Scroll
在窗口或特定区域上垂直或水平滚动。
Move
移动鼠标指针或拖拽（设置 drag=True）到坐标。
Shortcut
按下键盘快捷键（如 Ctrl+C、Alt+Tab）。
Wait
暂停一段定义的时间。
WaitFor
通过轮询 UI 状态，等待文本、活动窗口、元素或焦点元素出现。
DisplayInventory
读取显示布局、工作区域、有效 DPI 和缩放元数据。
Screenshot
快速截取桌面，包含光标位置、活动窗口和图像。
Snapshot
捕获完整桌面状态，用于交互式元素 ID、可滚动区域或基于 DOM 的浏览器提取。
App
通过开始菜单名称或可执行文件路径启动应用程序，并支持调整大小、移动和切换窗口。
PowerShell
执行 PowerShell 命令。
FileSystem
读取、写入、复制、移动、删除、列出、搜索和检查文件和目录。
Scrape
抓取整个网页的信息。
MultiSelect
使用可选的 Ctrl 键选择多个项目（文件、文件夹、复选框）。
MultiEdit
在指定坐标的多个输入字段中输入文本。
Clipboard
读取或设置 Windows 剪贴板内容。
Process
列出运行中的进程或按 PID 或名称终止它们。
Notification
发送包含标题和消息的 Windows 通知。
Registry
读取、写入、删除或列出 Windows 注册表值和键。
安装接入
- 确保安装 Python 3.13+ 和 UV（安装：
pip install uv）。2. 对于 Claude Desktop，添加以下配置到claude_desktop_config.json：{"mcpServers":{"windows-mcp":{"command":"uvx","args":["windows-mcp","serve"]}}}。3. 完全重启 Claude Desktop。4. 对于其他客户端，请参考 README 中的具体步骤。
claude_desktop_config.json
{
"mcpServers": {
"windows-mcp": {
"command": "uvx",
"args": [
"windows-mcp",
"serve"
]
}
}
}
选型与风险
不适合谁
- 非 Windows 平台（如 macOS、Linux）
- 需要精确文本选择或编程 IDE 支持的场景
- 支持操作系统上未涉及的旧版本 Windows
所需权限
- 通过 UI 自动化 API 访问 UI 元素
- 执行 PowerShell 命令
- 文件系统读写和删除
- 注册表读写
- 访问剪贴板
- 启动和管理进程
风险与副作用
- 具有完全系统访问权限，可能执行不可逆操作（如删除文件、修改注册表）
- 如果通过网络暴露，存在远程访问风险
- UI 自动化可能不稳定，尤其是在高负载或复杂 UI 下
- 它可能会干扰正在运行的应用程序或导致意外行为
常见排障
- 确保使用 Python 3.13+
- 确保使用 'English' 作为默认语言，或禁用 'App-Tool'
- 首次运行时，依赖安装可能需要 1-2 分钟
- 如果遇到 'Connection closed' 错误，请使用 uvx.exe 的完整路径
- 检查日志文件：`~/.windows-mcp/server.log` 和 `server.error.log`
使用场景
自动化桌面应用程序的 UI 交互
文件管理和导航
执行 PowerShell 命令和脚本
Web 抓取和浏览器自动化
QA 测试和桌面验证
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Perplexity Desktop完整支持
Gemini CLI完整支持
Qwen Code完整支持
Codex CLI完整支持
Autohand Code完整支持