sandbox-mcp(一次性Windows)

作者 模型前线

「在我机器上是好的」这种 bug,最可靠的复现方式是给它一台干净机器。sandbox-mcp 给 Agent 一台真的 Windows 11 虚拟机:部署、点控件、抓崩溃、留证据,用完就删,实测一次 GUI 操作约 40 到 50 秒。

Github
Skill 编程开发 v1.0.0 热度 285

将提示词发送给你的 AI 安装该 Skill

复制下方提示词,粘贴到 Cursor / Claude Code / WorkBuddy 等本地 Agent,按说明安装。

请根据 https://www.cweto.cn/?ai_hub=skill_install ,安装本站 Skill @ai_hub/work-83(sandbox-mcp(一次性Windows))。
详情页:https://www.cweto.cn/work-83.html
GitHub:https://github.com/shanselman/sandbox-mcp
请装到当前 Agent 的 skills 目录(见安装说明中的路径表),完成后重启或刷新 Agent。
安装说明 GitHub
支持的本地 Agent 目录
  • Claude Code → ~/.claude/skills/
  • Cursor → ~/.cursor/skills/
  • Windsurf → ~/.codeium/windsurf/skills/
  • Codex → ~/.codex/skills/
  • Gemini CLI → ~/.gemini/skills/
  • WorkBuddy → ~/.workbuddy/skills/
  • OpenClaw 变体 → 各自 skills 目录

Skill 说明

sandbox-mcp 是什么

sandbox-mcp 给 AI Agent 一台全新的 Windows 11 机器,用完就扔掉。它强调两点:不是你的桌面,也不是「假装成 Windows 的容器」,而是一台真的、一次性的 Windows 11 虚拟机——你可以开机、部署应用、驱动界面控件、捕获崩溃、留下证据,然后把这台机器删掉。

它有两个接口但同一套引擎:直接用 sbx 命令行,或者用可选的 MCP 适配器(给需要工具发现和内联图片的客户端)。

能力说明
真实 Windows 11 虚拟机不是容器模拟,可完整部署与操作
一次性用完删除,不污染宿主机
双接口sbx 命令行 + 可选 MCP 适配器
实测耗时GUI 采样端到端约 40–50 秒
免装 Node便携 ZIP 内含运行时(Windows x64)

典型的用法就是复现「在我机器上是好的」——在 30 秒级的循环里,让同一个 bug 在干净机器上现形。

sandbox-mcp 怎么安装

最省事的是下载便携版,不需要装 Node.js:下载 Windows x64 的便携 ZIP,里面带了运行时、虚拟机内的 agent 和配置说明。

要先在系统里打开 Windows 沙箱功能(Turn on Windows Sandbox)。

从源码装的话需要 Node.js 20 以上:

winget install OpenJS.NodeJS.LTS
git clone https://github.com/shanselman/sandbox-mcp

sandbox-mcp 怎么使用

  1. 确认 Windows 沙箱功能已开启,否则虚拟机起不来。
  2. 用 sbx 起一台全新的 Windows 11 虚拟机。
  3. 让 Agent 在里面部署你的应用,然后驱动界面控件走关键路径。
  4. 出现崩溃就保留证据(截图、日志),再把机器删掉。
  5. 需要接 MCP 客户端时启用可选的 MCP 适配器,工具和内联截图会暴露给客户端。
  6. 把这个循环接进 agent 插件,形成「改代码 → 干净机器验证」的快速内环。

sandbox-mcp 适合谁用

  • 做 Windows 桌面应用、需要干净环境复现问题的开发者。
  • 受够了「本地能跑、用户那里崩」这类环境差异 bug 的团队。
  • 想让 AI Agent 自己做端到端验证、包括点界面的自动化测试场景。
  • 需要隔离测试可疑程序、不想在自己机器上跑的人。
  • 只做纯 Web 或 Linux 后端、不碰 Windows GUI 的项目用不上。

sandbox-mcp 项目地址

  • GitHub 仓库:https://github.com/shanselman/sandbox-mcp
  • 项目官网:https://sandbox-mcp.dev
  • 作者:https://github.com/shanselman