Windows-MCP 让 Codex 操控电脑

通过 Windows-MCP 服务器，让 Codex 或 Claude Code 在 Windows 上实现 Computer Use。

项目地址：https://github.com/CursorTouch/Windows-MCP

这是什么

Windows-MCP 是一个轻量级 MCP 服务器，让 AI 代理可以直接操控 Windows 系统——点击按钮、打开应用、操作窗口、读取屏幕、执行命令，实现 Computer Use。

支持 Windows 7 / 8 / 10 / 11，不依赖特定视觉模型，任何 LLM 都能用。

主要功能

  • 屏幕操作：截图、点击、滚动、拖拽、键盘快捷键
  • 应用控制：从开始菜单启动应用、调整窗口大小、切换应用
  • 文件系统：读写、复制、移动、删除、搜索文件和目录
  • 网页抓取：Scrape 工具提取网页内容
  • DOM 模式：use_dom=True 专注网页内容，过滤浏览器 UI 元素
  • 命令执行：PowerShell 命令直接执行
  • 剪贴板：读取或设置剪贴板内容

前置条件

  • Python 3.13+
  • 安装 UV 包管理器：pip install uv
  • Windows 系统语言建议设为英文（否则需禁用 App-Tool）

在 Codex 中使用

编辑 ~/.codex/config.toml，添加 MCP 服务器配置：

[mcp_servers.windows-mcp]
command="uvx"
args=[
  "windows-mcp",
  "serve"
]

重启 Codex 即可。Codex 会自动识别 Windows-MCP 提供的工具，你可以在对话中让它操控电脑。

在 Claude Code 中使用

claude mcp add --transport stdio windows-mcp -- uvx windows-mcp serve

重启 Claude Code，用 /mcp 确认服务器状态。

使用示例

配置完成后，直接用自然语言让 Codex 操控电脑：

帮我打开 Chrome 浏览器，访问百度，搜索"Windows MCP"

截个图看看当前桌面状态

打开文件管理器，找到桌面上的 report.docx，帮我重命名为 report-final.docx

排错

  • 首次安装超时 → 正常，依赖安装需要时间，重启即可
  • Windows 非英文系统 → 禁用 App-Tool：配置中加 --exclude-tools "App"
  • WSL 环境 → MCP 服务器必须在 Windows 侧运行，用 powershell.exe 桥接