Vmcraft
БесплатноНе проверенLocal VM workstation for VirtualBox, Hyper-V, and Firecracker with CLI, MCP, and egui app.
Описание
Local VM workstation for VirtualBox, Hyper-V, and Firecracker with CLI, MCP, and egui app.
README
Pure-Rust ArtCraft Virtual Machine workstation for local virtualization management and agentic tooling. One unified Rust workspace providing an in-process core domain library (L1), a dual-mode human CLI and JSON-RPC Model Context Protocol (MCP) server (L2), and an interactive native egui desktop workstation (L3).
Status: v1.1.0, Tier 4 (L1 core + L2 CLI/MCP + L3 egui desktop app, multi-hypervisor VirtualBox 7+, Hyper-V, and Firecracker KVM Micro-VMs, ArtCraft Command Bus, Clean-Room Detonation Pipeline & Airgap Isolation).
- Changes: CHANGELOG.md
- Conversion Dossier: docs/CONVERSION_DOSSIER.md
- Audit Log: docs/CONVERSION_LOG.md
- Agent Guide: AGENTS.md
- Handover: HANDOVER.md
Architecture
| Crate | Layer | Purpose |
|---|---|---|
crates/vmcraft-core |
L1 | In-process command dispatch bus (Command::dispatch), ArtCraft command bus registry (commands_catalog, describe_command, parse_command), VBoxManage orchestration, Hyper-V CIM probe, ephemeral sandbox execution, strict input validators. |
crates/vmcraft-mcp |
L2 | Binary providing human CLI subcommands (commands --json, describe, run, batch, vm, hyperv, snapshot, etc.) and standard Model Context Protocol (MCP) JSON-RPC stdio. Dual-aliased to support both modern vmcraft.* names and legacy portmanteaus (vm_management, snapshot_management, hyperv_management, etc.). |
crates/vmcraft-app |
L3 | Native eframe/egui desktop application with 9 functional tabs, non-blocking asynchronous message passing (mpsc::channel), live multi-hypervisor VM table, snapshot tree controls, in-app framebuffer image viewer, command bus explorer, and safety gating. |
Desktop Workstation (vmcraft-app)
Launch via:
.\start.ps1
# or via fleet launcher:
..\mcp-central-docs\starts\vmcraft-start.bat
Features
- Instant Background Discovery: Automatically polls hypervisors (VirtualBox + Hyper-V), VM list, and host templates upon opening without blocking the UI thread.
- Dashboard: Live multi-hypervisor VM overview table showing VM Name, Provider (
VirtualBoxin amber,Hyper-Vin cyan), UUID, and instant action buttons (Select,Info,Start,Stop), plus an activity log. - VMs Page: Quick target selector bar, VM configuration form, start/stop/create/delete controls, and detailed hardware inspect output.
- Snapshots Page: Point-in-time snapshot listing in a structured table, with one-click
RestoreandDeleteper snapshot. - Network Page: VirtualBox host-only network interface management (
list,create,remove). - Disks Page: Virtual disk image (
.vdi) inspection and dynamic provisioning. - Shot Page: Framebuffer screenshot capture with live in-app PNG rendering directly inside the GUI.
- Sandbox Page: Safe, isolated 30-second script runner for Python and PowerShell.
- Detonate Page: Clean-room detonation and disassembly pipeline under hardware-level airgap. Supports automated snapshotting, keygen explosion, target binary injection, in-guest disassembly, non-executable artifact extraction, and auto-nuke/rollback.
- Commands Page: Interactive ArtCraft command bus catalog and custom command dispatcher.
- Help & Safety: Visual toggle for mutating operations gate.
MCP Server Configuration
To register vmcraft as an MCP server in Claude Desktop, OpenCode, or Cursor:
{
"mcpServers": {
"vmcraft": {
"command": "D:/Dev/repos/vmcraft/target/release/vmcraft-mcp.exe",
"args": ["mcp"]
}
}
}
MCP Tools & Dual Aliases
All tools are dual-aliased to ensure 100% backward compatibility with legacy tooling:
vmcraft.status/virtualization_shutdown/info_toolsvmcraft.vm_list,vmcraft.vm_info,vmcraft.vm_create,vmcraft.vm_start,vmcraft.vm_stop,vmcraft.vm_delete(legacy alias:vm_management)vmcraft.snapshot_list,vmcraft.snapshot_create,vmcraft.snapshot_restore,vmcraft.snapshot_delete(legacy alias:snapshot_management)vmcraft.network_list,vmcraft.network_create,vmcraft.network_remove(legacy alias:network_management)vmcraft.disk_list,vmcraft.disk_create(legacy alias:storage_management)vmcraft.vm_shot(captures PNG screenshot)vmcraft.host_info(legacy alias:system_management)vmcraft.sandbox_run(legacy alias:create_sandbox,stop_sandbox)vmcraft.hyperv_list,vmcraft.hyperv_start,vmcraft.hyperv_stop(legacy alias:hyperv_management)vmcraft.commands,vmcraft.describe,vmcraft.run(ArtCraft Command Bus)vmcraft.airgap_set(Hardware/link-level network disconnect & clipboard/DnD block)vmcraft.guest_exec,vmcraft.guest_copyto,vmcraft.guest_copyfrom(In-guest orchestration via guest additions)vmcraft.pipeline_detonate(Untrusted keygen explosion, in-guest disassembly under airgap, clean extraction, and auto-rollback)vmcraft.pipeline_naked_install(Clean baseline consumer install verification)vmcraft.firecracker_probe,vmcraft.firecracker_list,vmcraft.firecracker_spawn,vmcraft.firecracker_kill(Sub-10ms KVM micro-VMs)
CLI Usage
# Check hypervisor status
vmcraft-mcp status
# List all registered VMs (VirtualBox + Hyper-V)
vmcraft-mcp vm list
# Inspect detailed hardware configuration of a VM
vmcraft-mcp vm info --vm "ubu-2404-lts"
# Start a VM (mutating operations require --yes or VMCRAFT_ALLOW_MUTATE=1)
vmcraft-mcp vm start --vm "ubu-2404-lts" --yes
# Take a snapshot
vmcraft-mcp snapshot create --vm "ubu-2404-lts" --snap "clean-state" --yes
# Capture a screenshot from a running VM
vmcraft-mcp shot --vm "ubu-2404-lts" --out "screenshot.png"
# Execute code in the safe isolated sandbox
vmcraft-mcp sandbox run --lang python --code "print('hello from sandbox')"
# Explore ArtCraft command bus catalog
vmcraft-mcp commands --json
vmcraft-mcp describe pipeline.detonate
# Clean-room air-gapped detonation & disassembly of untrusted binary
vmcraft-mcp pipeline detonate `
--vm "win11" `
--keygen "C:\malware\keygen.exe" `
--target "C:\bin\target.exe" `
--disassembler "ida64.exe" `
--host-output "output.asm" `
--yes
# Immediately sever all network links and clipboard to airgap a VM
vmcraft-mcp airgap "win11" --disconnect
# Verify clean-room consumer install on pristine baseline
vmcraft-mcp pipeline naked-test --repo "my-org/my-app" --yes
# Probe WSL2 KVM acceleration for Firecracker micro-VMs
vmcraft-mcp firecracker probe
# Spawn a dedicated sub-10ms ephemeral micro-VM
vmcraft-mcp firecracker spawn --id "agent-worker-1" --kernel "/vmlinux" --rootfs "/rootfs.ext4" --yes
Safety & Containment Rules
- Mutating Operations Gate: Operations that modify system or VM state (
vm create/start/stop/delete,snapshot create/restore/delete,network create/remove,disk create,airgap,guest.exec,pipeline.detonate,pipeline.naked_install,firecracker spawn/kill) require explicit confirmation via--yes,VMCRAFT_ALLOW_MUTATE=1, or the UI checkbox. - Zero-Unwrap Policy: Workspace compiles under strict denial of
unwrap_used,expect_used,panic,todo, andunimplemented. - Stdio Isolation: The MCP server guarantees that
stdoutis exclusively reserved for valid JSON-RPC frames; all diagnostic logs are directed tostderr.
Verification & Testing
# Run full workspace test suite (30 tests)
cargo test --workspace
# Lint with strict zero-warning policy
cargo clippy --workspace --all-targets --all-features -- -D warnings
# Verify formatting
cargo fmt --all --check
# Test application smoke harness
cargo run -p vmcraft-app --release -- --smoke
Установка Vmcraft
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/sandraschi/vmcraftFAQ
Vmcraft MCP бесплатный?
Да, Vmcraft MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Vmcraft?
Нет, Vmcraft работает без API-ключей и переменных окружения.
Vmcraft — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Vmcraft в Claude Desktop, Claude Code или Cursor?
Открой Vmcraft на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
автор: GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
автор: UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
автор: duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
автор: blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
автор: Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
автор: runapi-aiCompare Vmcraft with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
