{"name":"sandbox-mcp: Test Windows Apps in Disposable Windows Sandbox","description":"sandbox-mcp uses Windows Sandbox to test apps on fresh, disposable Windows 11 machines, with a CLI and optional MCP adapter for AI agents. It captures UI, process, crash, and installer evidence, helping developers check how apps behave on a clean customer PC.","github":"https://github.com/shanselman/sandbox-mcp","url":"https://osrepos.com/repo/shanselman-sandbox-mcp","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/shanselman-sandbox-mcp","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/shanselman-sandbox-mcp.md","json":"https://osrepos.com/repo/shanselman-sandbox-mcp.json","topics":["javascript","windows","mcp-server","testing","windows-sandbox","ui-automation","installer-testing"],"keywords":["javascript","windows","mcp-server","testing","windows-sandbox","ui-automation","installer-testing"],"stars":null,"summary":"sandbox-mcp uses Windows Sandbox to test apps on fresh, disposable Windows 11 machines, with a CLI and optional MCP adapter for AI agents. It captures UI, process, crash, and installer evidence, helping developers check how apps behave on a clean customer PC.","content":"## Overview\n\nsandbox-mcp is a Windows Sandbox automation tool for checking how Windows apps behave on a fresh, disposable Windows 11 machine. Its `sbx` CLI and optional MCP server share the same engine, which boots a guest, deploys or installs an app, runs checks, collects evidence, and destroys the guest. This targets the gap between an app working on a developer’s machine and working on a clean customer PC.\n\nThe project is for Windows developers and AI agents that need to test real desktop apps without using the developer’s own desktop. It supports UI Automation, screenshots, crash checks, installer and uninstaller audits, and observations of untrusted files. Windows Sandbox is available on Windows 11 Pro, Enterprise, or Education, not Windows Home or Windows Server.\n\n## Key Features\n\n- Run an app in a fresh Windows Sandbox guest and keep reports and evidence on the host after teardown.\n- Use native UI Automation to inspect controls and interact with WinForms, WPF, Win32, and WinUI apps.\n- Test MSIX and other packaged apps, as well as executable and folder-based apps.\n- Diagnose likely app dependencies on the host, with runtime provisioning available only when explicitly requested.\n- Test installers and uninstallers by comparing system snapshots and reporting leftovers such as files, registry keys, services, and autoruns.\n- Detonate supported files in an isolated guest and report observed processes, network activity, persistence, and changes.\n- Capture screenshots and bounded recordings, with optional MCP tools that can return screenshots inline.\n\n## Use Cases\n\n- A Windows app developer can check whether a fresh customer machine has the runtime needed to launch an app, and retain the failure report and screenshot.\n- A QA engineer can automate a desktop smoke test through UI Automation without relying on pixel coordinates for ordinary controls.\n- An installer developer can see what an uninstall leaves behind and use the results to improve cleanup.\n- An AI-agent developer can let an agent build, test, and inspect a Windows app in a disposable guest rather than the user’s desktop.\n- A security-conscious user can observe the behavior of a suspicious script or installer in an isolated guest, with networking disabled by default for detonation.\n\n## Our Take\n\nThis is a promising, actively changing Windows testing tool with substantial functionality, but its short history and reliance on one main contributor make it an early-stage choice.\n\n**Good fit if:**\n- You need repeatable clean-machine checks for Windows desktop apps and can run Windows Sandbox on a supported Windows edition.\n- Your workflow benefits from UI Automation, installer audits, or durable test evidence rather than only checking whether an app launches.\n- You want an optional MCP interface for an agent, or prefer to use the standalone CLI.\n\n**Look elsewhere if:**\n- You need Linux, Windows Home or Windows Server support, parallel sandbox guests, or persistent guest machines.\n- Your work requires a broad, mature contributor base: most recent project activity comes from one person, despite contributions from others.\n- You need a general malware-analysis lab or assurance that every Windows app and hardware-dependent workload will work in Sandbox.\n\n## Project Health\n\n| Signal | Value |\n|---|---|\n| Status | **New**: less than six months old and changing fast |\n| Last commit | 2026-11-15 (1 day ago) |\n| Commits, last 90 days | 61 |\n| Releases, last 12 months | 3 (latest v1.2.0, 2026-11-07) |\n| Contributors | 4 (top contributor: 90% of commits) |\n| Issues closed, last 90 days | 0 |\n| Pull requests merged, last 90 days | 5 (typically merged in 0 days) |\n| Project age | 10 days |\n\nChecked on 2026-11-17 with the GitHub API.\n\n## Project Facts\n\n- Language: JavaScript\n- License: MIT\n- Stars: 452\n- Forks: 22\n- Topics: ai-agents, mcp, mcp-server, testing, ui-automation, windows, windows-sandbox\n- Website: https://shanselman.github.io/sandbox-mcp/\n- Archived: no\n\n## What You Need\n\nDetected in the repository:\n\n- Node.js >=20 (from package.json)\n- A test suite and automated checks on GitHub Actions\n\n## Getting Started\n\nDownload a Windows x64 portable ZIP from the [GitHub releases page](https://github.com/shanselman/sandbox-mcp/releases/latest), extract it, and run the readiness check in PowerShell:\n\n```powershell\n.\\sbx.cmd doctor\n```\n\nThe portable package includes a runtime, so a separate Node.js installation is not required. See the [README](https://github.com/shanselman/sandbox-mcp) for enabling Windows Sandbox, running a first test, and configuring an MCP client.\n\n## License in Plain Words\n\n**MIT** (permissive).\n\n- Commercial use: yes\n- Modify and redistribute: yes\n- You must keep: the copyright and license notice\n- Share your changes: no\n\nA summary, not legal advice: the LICENSE file is what applies.\n\n## Considerations\n\n- The project is new and changing quickly. It has recent development activity and releases, but most of the code comes from one person, so teams should assess maintenance continuity before depending on it.\n- Running from source requires Node.js 20 or later. The portable Windows x64 release bundles a runtime; ARM64 is not currently packaged.\n- The host needs Windows 11 24H2 or later, a supported Windows edition, virtualization, and a logged-in desktop session. Windows Sandbox permits only one guest at a time.\n- Fresh guests do not retain installed apps or prerequisites. Dependency diagnosis is a conservative scan, and provisioning changes the result from a clean-machine test to a provisioned test.\n- The project notes that Windows Sandbox is not a guarantee against a hypervisor escape and is not a dedicated malware-analysis lab.\n- The repository is MIT licensed.","metrics":{"detailViews":3,"githubClicks":1},"dates":{"published":null,"modified":"2026-11-17T01:51:27.000Z"}}