🚀 Hyper-V Sandbox MCP Server for Antigravity 2.0

격리된 Hyper-V 가상 머신 내부에서 PowerShell, CMD/BAT 스크립트 및 시스템 유틸리티를 자율적으로 테스트, 검증, 디버깅하기 위한 안전한 AI 에이전트용 샌드박스입니다.

Hyper-V Sandbox MCP Server는 Model Context Protocol(MCP) 서버로, 여러분의 로컬 Microsoft Hyper-V 하이퍼바이저를 AI 에이전트가 관리하는 코드 테스트 환경으로 바꿔 줍니다. 에이전트(Antigravity 2.0, Claude Desktop 등)는 VM을 깨끗한 스냅샷으로 자동 복원하고, VMBus를 통해 대역 외(Out-of-band)로 파일을 전송하며, PowerShell Direct로 게스트 내부에서 명령을 실행하고, 출력을 분석한 뒤 오류가 발생하면 스스로 수정하는 능력(자가 복구 루프)을 갖게 됩니다.

• 🌟 주요 기능

• 🛡️ 100% 호스트 보호(Zero-Risk Sandbox): 시스템 서비스 수정, 레지스트리 편집, 네트워크 어댑터 변경, 파일 삭제 등 잠재적으로 파괴적인 스크립트는 격리된 가상 머신 내부에서만 실행됩니다.

• ⚡️ PowerShell Direct(네트워크 의존성 제로): 게스트 OS 관리는 하이퍼바이저 내부의 VMBus를 통해 동작하며, 네트워크 구성, RDP/SSH/WinRM 포트 개방, 방화벽 변경이 필요하지 않습니다.

• 🔄 결정적 롤백(CleanBase Checkpoint): 매 실행 전 VM이 깨끗한 기준 스냅샷으로 재설정되어 잔여 상태 없이 완전히 재현 가능한 테스트를 보장합니다.

• 📦 원활한 파일 전송(게스트 통합 서비스): 네이티브 Copy-VMFile 사용으로 스크립트, 라이브러리, 유틸리티(예: PsExec)를 호스트에서 게스트로 직접 전송할 수 있습니다.

• 🤖 자가 복구 코드 루프: 에이전트는 실제 출구 코드(ExitCode), stdout, stderr 출력과 예외 스택 트레이스를 수집하여 코드를 자동으로 패치하고 테스트가 통과할 때까지 재실행합니다.