ClaudeMap

sandbox-mcp

给 AI agent 一台用完即弃的全新 Windows 11:Windows Sandbox 干净客户机,配 sbx CLI 与可选 MCP 适配器——部署应用、驱动 UI、抓崩溃、留证据、删机器(Windows Pro/Enterprise/Education,MIT)

MCP 服务器windowssandboxmcp servertestingui automation

sandbox-mcp 把 Windows Sandbox 变成 agent 的「全新客户 PC」:每次运行启动一台真实的、一次性的 Windows 11 虚拟桌面——部署应用、用 UI Automation 驱动控件、抓崩溃现场、留存报告与审计日志,然后整台机器删除(撰稿时 400 星,2026-11-11)。CLI(sbx)可独立使用,MCP 适配器是可选的第二界面,两者共用同一引擎,实测 GUI 样例端到端约 40-50 秒。典型任务:干净机器冒烟测试(缺 VC++ 运行库、.NET 或 WebView2 会怎样)、安装包/卸载包审计(sbx install-test 记录每个文件、注册表项、服务与计划任务)、断网引爆可疑文件(sbx detonate 汇报进程、DNS 查询与落盘 autorun)、以及「构建-上干净机测-看截图-修复」的 agent 闭环。默认绝不安装依赖;显式 opt-in 的 provision 会校验 SHA-512 哈希与微软签名,并把结果标注为 PROVISIONED(非干净机器测试)。README 附七种配置的实测兼容矩阵,项目主页在 https://shanselman.github.io/sandbox-mcp/。

它做什么

  • 真实、一次性的 Windows 11 客户机:启动、部署、驱动控件、抓崩溃、留证据、删机器(v1.2.0)
  • 一个引擎、两个界面:sbx CLI 可独立使用,可选 MCP 适配器暴露 sandbox_deps / sandbox_run / sandbox_provision / sandbox_status 工具并支持内联图片
  • 用 UI Automation 而非像素驱动 UI:读控件树、设文本、点击、切换、等待——覆盖 WinUI 3、WPF、WinForms、Win32 与打包应用
  • sbx detonate 在断网沙箱里运行不可信文件,汇报它启动的每个进程、查询的 DNS 名、尝试的地址,以及落盘的 autorun、计划任务、服务与文件
  • 证据在销毁后仍在:截图、拷出的文件、report.md / report.json 与 audit.jsonl 留在主机的 %LOCALAPPDATA%\sandbox-mcp\runs\<timestamp>

什么时候用

适合 Windows 开发者与测试工程师回答「在干净的客户机上它到底能不能装、能不能跑」:依赖冒烟测试、安装包审计、断网引爆可疑文件、以及让 agent 在不碰真实桌面的前提下完成修复闭环;也适合把不可信文件隔离在无网络沙箱里观察行为。

如何上手

# 从 https://github.com/shanselman/sandbox-mcp/releases/tag/v1.2.0 下载 Windows x64 便携 ZIP(v1.2.0,先用旁边的 .sha256 校验);ZIP 自带 Node.js,无需另装 Node/npm

# 就绪检查(它自己不会开启功能、提权、改 PATH 或重启):
.\sbx.cmd doctor

# 若 Sandbox 功能未开启——用管理员 PowerShell 执行后重启 Windows:
Enable-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM -All
# 重启后从开始菜单打开一次 Windows Sandbox(这一步会装上 sbx 依赖的 wsb 命令行工具)

# 可选 MCP 适配器——VS Code 的 .vscode\mcp.json 形态(把示例目录换成你的解压目录):
{
  "servers": {
    "windows-sandbox": {
      "type": "stdio",
      "command": "C:\\Users\\you\\Downloads\\sandbox-mcp\\node.exe",
      "args": ["C:\\Users\\you\\Downloads\\sandbox-mcp\\src\\server.js"]
    }
  }
}

# Claude Desktop 用 "mcpServers" 加同样的 command/args,省略 "type" 与 "tools"(README 原话)

# 然后试一下:.\sbx.cmd run C:\Windows\System32\charmap.exe --open

注意事项

仅限 Windows 且分版本:Windows Sandbox 需要 Windows 11 24H2(build 26100)或更高,且限于 Pro、Enterprise、Education——Home 与 Windows Server 跑不了;UEFI/BIOS 里需开启虚拟化(Intel VT-x / AMD-V);内存至少 4 GB(建议 8 GB)、2 核 CPU、1 GB 空闲磁盘。一次只能跑一个沙箱,且按设计无持久化——客户机里要留下的产出必须显式共享到主机。便携 ZIP 在原生 Windows x64 上构建与测试;ARM64 目前没有打包。默认绝不安装依赖:provision 只在显式请求时发生,provisioned 的通过会标注 PROVISIONED,绝不冒充干净机器测试;README 明确表示这不是「每个 Windows 应用都能在 Sandbox 里跑」的承诺,实测兼容矩阵覆盖七种配置。在虚拟机里跑则要先在宿主机开启嵌套虚拟化。MIT。撰稿时 400 星(2026-11-11)。

代码仓库

shanselman/sandbox-mcp

收录日期

地图上的相关资源

  • Blitz Strike

    MCP 服务器

    把渗透测试方法论装进一个 MCP server:BLITZ 摸清攻击面,EAGLE-EYE 追 source-to-sink,STRIKE 对每条发现先实测再上报。

    • mcp-server
    • security
    • pentest
    • methodology
  • Ripwire

    MCP 服务器

    Red Hat 出品的「AI 上下文版 ripgrep」——C++23 零依赖 CLI,同时讲 MCP。

    • mcp
    • code-context
    • cli
    • red-hat
  • Deja Vu

    MCP 服务器

    让 25+ 个编码 agent 共享同一份会话记忆——Claude Code、Codex、Cursor 终于记得同一个项目。

    • mcp
    • memory
    • cross-agent
    • context