# GuestKit

GuestKit inspects a powered-off VM disk offline and rates its first-boot readiness. Use it before migration or a hypervisor cutover.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: zyvorai
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zyvorai/zyvor-guestkit
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/guestkit

## What it does

GuestKit works on one VM disk image while the guest is shut down. Its MCP server reads qcow2, VMDK, VHDX, VHD, VDI, and raw images through NBD or a loop mount, then returns a 0–100 boot-readiness score with the causes behind each blocker.

It can produce a reviewable repair plan, CI check data, and a signed Cutover Passport. The available description also covers migration plans for 8 targets and a container entry point at `ghcr.io/zyvorai/guestkit-mcp:1.2.9`. Docker is required for the shown Claude Code setup; without it, the GuestKit container cannot start.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add guestkit -- docker run -i --rm ghcr.io/zyvorai/guestkit-mcp:1.2.9
```

### Codex

**Platform CLI**
```bash
codex mcp add guestkit -- docker run -i --rm ghcr.io/zyvorai/guestkit-mcp:1.2.9
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "guestkit": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/zyvorai/guestkit-mcp:1.2.9"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "guestkit": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/zyvorai/guestkit-mcp:1.2.9"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add guestkit docker run -i --rm ghcr.io/zyvorai/guestkit-mcp:1.2.9
```

## When to use it
- check whether a VM image can boot on first launch
- trace the blockers behind failed guest startup
- create a repair plan for an offline disk
- gate migration checks in CI
- record disk evidence in a Cutover Passport

## Example prompts
- Inspect `vm.qcow2` offline and explain what blocks its first boot.
- Score `server.vmdk` for migration readiness and write a repair plan.
- Prepare a CI-ready report for `legacy.raw`.

## Similar
- [disk-forensics](https://affpapa.org/en/nevibecode/skills/disk-forensics.md) — skill · 357 installs
- [kernel-exploitation](https://affpapa.org/en/nevibecode/skills/kernel-exploitation.md) — skill · 3600 installs
- [cross-gcc](https://affpapa.org/en/nevibecode/skills/cross-gcc.md) — skill · 682 installs
- [qemu-for-kernel-development](https://affpapa.org/en/nevibecode/skills/qemu-for-kernel-development.md) — skill · 319 installs
- [mcp-proxmox](https://affpapa.org/en/nevibecode/mcp/mcp-proxmox.md) — MCP server · ★ 17
- [app-marketplace-review](https://affpapa.org/en/nevibecode/skills/app-marketplace-review.md) — skill · 8100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md