← 返回目录
W

Windows MCP

社区
Windows-MCP 是一个轻量级开源项目,使 AI 代理能够无缝集成和操作 Windows 操作系统。
分类
其他 第 168 / 230
Stars
★ 8.6k 非常热门
传输方式
stdio(本地进程) · SSE · Streamable HTTP
运行环境
Python 3.13+ · 预编译二进制
凭据
无需凭据
许可证
MIT
最近提交
工具数
20
47FMRS · D

Windows-MCP 是连接 AI 代理与 Windows 系统的强大工具,提供了全面的 UI 自动化工具集。其轻量级设计和广泛兼容性使其易于集成。然而,由于具有系统级权限,需谨慎配置安全措施,特别是远程访问时。总体而言,对于需要 Windows 自动化的用户,它是一个可靠的选择。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 3/20

可靠性
7/20
安全与权限
3/20
维护活跃度
10/20
文档质量
14/20
安装易用性
13/20
查看各项评分依据
可靠性 7/20
README 与 manifest 显示这是一个通过 uvx/stdio 运行、工具集丰富的 MCP 服务,快乐路径看似合理;但未提供源代码、CI 或测试,无法验证实际初始化、握手和工具行为。首次运行可能超时、要求 Python 3.13+,进一步增加不确定性,因此保守给分。
安全与权限 3/20
存在红线风险:PowerShell、注册表写入、文件删除、进程终止等高风险工具默认全部启用且没有人工确认步骤;SSE/streamable HTTP 等远程传输可将其暴露,且默认遥测会向 PostHog 发出外部网络请求。虽然提供了 auth key、IP 白名单、TLS、OAuth、工具白名单等缓解措施,但缺少对不可逆/远程命令的默认确认,按红线规则只能落在 0-4 区间。
维护活跃度 10/20
仓库未归档、具有 MIT 许可证、有 10 个未关闭 issue,且发布了 PyPI 包与 1.0.1 版本,说明处于活跃维护状态;但未提供提交频率、CI、依赖更新或 issue 响应周期等证据,版本治理仍有缺口,因此给 10 分。
文档质量 14/20
README 覆盖了多客户端安装配置、传输方式、安全配置、环境变量、工具列表、遥测说明和限制,层次较完整;但缺少逐工具的参数参考、专门的故障排查章节,首次运行超时等问题也只是简单提及,未深入展开。
安装易用性 13/20
提供了 uvx 安装方式和 Claude Desktop、Perplexity、Gemini、Qwen、Codex、Claude Code 等主流客户端的配置示例,并补充了 WSL 与 MSIX 特殊场景;但需要 Python 3.13+ 与 uv,首次运行可能超时,MSIX 需要手工绝对路径配置,步骤虽清晰仍有一定脆弱性,且无可执行的 CI/测试证据。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络控制浏览器

适合谁

  • 需要在 Windows 上进行 UI 自动化的开发者和 QA 工程师
  • 希望将 AI 代理与桌面应用程序集成的人员
  • 需要执行文件和注册表操作的系统管理员

不适合谁

  • 非 Windows 平台(如 macOS、Linux)
  • 需要精确文本选择或编程 IDE 支持的场景
  • 支持操作系统上未涉及的旧版本 Windows

所需权限

  • 通过 UI 自动化 API 访问 UI 元素
  • 执行 PowerShell 命令
  • 文件系统读写和删除
  • 注册表读写
  • 访问剪贴板
  • 启动和管理进程

风险与副作用

  • 具有完全系统访问权限,可能执行不可逆操作(如删除文件、修改注册表)
  • 如果通过网络暴露,存在远程访问风险
  • UI 自动化可能不稳定,尤其是在高负载或复杂 UI 下
  • 它可能会干扰正在运行的应用程序或导致意外行为

安装接入

准备工作

运行环境:Python 3.13+ · 预编译二进制

WINDOWS_MCP_AUTH_KEY 可选密钥 可选的 Bearer 令牌,用于 HTTP/SSE 远程访问鉴权,需自行生成。
WINDOWS_MCP_OAUTH_CLIENT_SECRET 可选密钥 可选,OAuth 2.0 客户端密钥,与 CLIENT_ID 成对使用。
POSTHOG_API_KEY 可选密钥 可选,覆盖遥测使用的 PostHog 写入密钥,设为空可跳过初始化。
其他可选配置项(16 个)
WINDOWS_MCP_SCREENSHOT_SCALE 可选 可选,设置截图缩放比例(0.1–1.0),用于高分辨率显示器下缩小图片体积,无需获取。
WINDOWS_MCP_SCREENSHOT_BACKEND 可选 可选,指定截图后端(auto/dxcam/mss/pillow),默认 auto。
WINDOWS_MCP_PROFILE_SNAPSHOT 可选 可选,设为 1 输出截图/快照各阶段耗时日志。
WINDOWS_MCP_DISABLE_FLASH 可选 可选,设为 1 关闭截图后闪烁的橙色边框提示。
WINDOWS_MCP_IP_ALLOWLIST 可选 可选,逗号分隔的允许 IP/CIDR 列表,用于远程访问限流。
WINDOWS_MCP_CORS_ORIGINS 可选 可选,逗号分隔的允许跨域来源列表。
WINDOWS_MCP_TOOLS 可选 可选,逗号分隔的白名单,仅启用指定工具。
WINDOWS_MCP_EXCLUDE_TOOLS 可选 可选,逗号分隔的黑名单,禁用指定工具(如 PowerShell,Registry)。
WINDOWS_MCP_SSL_CERTFILE 可选 可选,TLS 证书文件路径,需与 KEYFILE 成对提供,可自行用 openssl 生成。
WINDOWS_MCP_SSL_KEYFILE 可选 可选,TLS 私钥文件路径,需与 CERTFILE 成对提供。
WINDOWS_MCP_OAUTH_CLIENT_ID 可选 可选,OAuth 2.0 客户端 ID,用于 HTTP 传输鉴权,需自行预注册。
WINDOWS_MCP_STATELESS_HTTP 可选 可选,设为 1 使 streamable-http 无会话状态,便于重连和横向扩展。
ANONYMIZED_TELEMETRY 可选 可选,设为 false 可关闭匿名使用统计。
POSTHOG_HOST 可选 可选,遥测使用的 PostHog 主机地址,默认 https://us.i.posthog.com。
WINDOWS_MCP_DEBUG 可选 可选,设为 1 开启 DEBUG 级别日志。
WINDOWS_MCP_WATCHDOG 可选 可选,设为 off 可禁用 UIA 焦点看门狗以提升长期运行稳定性。
  1. 确保安装 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp",
        "serve"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。

Terminal
claude mcp add windows-mcp -- uvx windows-mcp serve

在终端运行;先把 <…> 占位符换成你自己的值。

验证是否装好

在 MCP 客户端中启动服务器后(uvx windows-mcp serve),在工具列表中应能看到 Screenshot、Click、Snapshot 等 20 个工具;调用 Screenshot 或运行 PowerShell 工具查询系统信息,若能返回结果即说明连接成功。

常见排障

  1. 确保使用 Python 3.13+
  2. 确保使用 'English' 作为默认语言,或禁用 'App-Tool'
  3. 首次运行时,依赖安装可能需要 1-2 分钟
  4. 如果遇到 'Connection closed' 错误,请使用 uvx.exe 的完整路径
  5. 检查日志文件:`~/.windows-mcp/server.log` 和 `server.error.log`

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 截一张当前桌面的截图,告诉我现在打开着哪些窗口。
  • 打开记事本,在里面输入'你好,Windows-MCP'。
  • 列出 C:\Users 目录下的文件和文件夹。
  • 帮我查看当前运行的进程,结束占用内存最多的那个。

工具能力 20

Click 写入
在给定坐标处点击屏幕。
Type 写入
在元素上输入文本(可选择清除现有文本)。
Scroll 只读
在窗口或特定区域上垂直或水平滚动。
Move 写入
移动鼠标指针或拖拽(设置 drag=True)到坐标。
Shortcut 写入
按下键盘快捷键(如 Ctrl+C、Alt+Tab)。
Wait 只读
暂停一段定义的时间。
WaitFor 只读
通过轮询 UI 状态,等待文本、活动窗口、元素或焦点元素出现。
DisplayInventory 只读
读取显示布局、工作区域、有效 DPI 和缩放元数据。
展开其余 12 个工具
Screenshot 只读
快速截取桌面,包含光标位置、活动窗口和图像。
Snapshot 只读
捕获完整桌面状态,用于交互式元素 ID、可滚动区域或基于 DOM 的浏览器提取。
App 写入
通过开始菜单名称或可执行文件路径启动应用程序,并支持调整大小、移动和切换窗口。
PowerShell 破坏性
执行 PowerShell 命令。
FileSystem 写入
读取、写入、复制、移动、删除、列出、搜索和检查文件和目录。
Scrape 只读
抓取整个网页的信息。
MultiSelect 写入
使用可选的 Ctrl 键选择多个项目(文件、文件夹、复选框)。
MultiEdit 写入
在指定坐标的多个输入字段中输入文本。
Clipboard 写入
读取或设置 Windows 剪贴板内容。
Process 破坏性
列出运行中的进程或按 PID 或名称终止它们。
Notification 写入
发送包含标题和消息的 Windows 通知。
Registry 破坏性
读取、写入、删除或列出 Windows 注册表值和键。

使用场景

自动化桌面应用程序的 UI 交互
文件管理和导航
执行 PowerShell 命令和脚本
Web 抓取和浏览器自动化
QA 测试和桌面验证

支持客户端

Claude Desktop
Claude Code
Perplexity Desktop
Gemini CLI
Qwen Code
Codex
Autohand Code

依据项目文档列出,未经本站实测。

详细介绍

Windows-MCP 是一个轻量级、开源的 MCP 服务器,它在 AI 代理和 Windows 操作系统之间架起桥梁,使代理能够执行文件导航、应用程序控制、UI 交互、QA 测试等任务。它支持 Windows 7 到 11。它提供丰富的工具集,用于 UI 自动化,包括模拟键盘鼠标操作、捕获窗口/UI 状态,以及访问 PowerShell、文件系统、注册表等。该服务器基于 MIT 许可证发布。

同类可选方案

BioMCP 75 · B

统一的命令行语法,接入约30个可信生物医学数据源。

★ 653 · 工具数 11 与当前对比 →

源版本 b74c507d9e70 数据同步于 2026-10-11 查看 FMRS 评分方法