# GuestKit

GuestKit проверяет образ виртуальной машины офлайн и оценивает готовность к первому запуску. Он пригодится перед миграцией или переключением гипервизора.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: zyvorai
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/zyvorai/zyvor-guestkit
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/mcp/guestkit

## Что делает

GuestKit работает с одним образом диска, пока гостевая система выключена. MCP-сервер анализирует qcow2, VMDK, VHDX, VHD, VDI и raw через NBD или loop mount, затем выдаёт оценку готовности к загрузке от 0 до 100 и объясняет найденные блокеры.

Сервер формирует читаемый план исправлений, данные для CI-проверки и подписанный Cutover Passport. В описании также указаны планы миграции для 8 целей и запуск через контейнер `ghcr.io/zyvorai/guestkit-mcp:1.2.9`. Для способа установки через Claude Code нужен Docker: без него контейнер GuestKit не запустится.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add guestkit -- docker run -i --rm ghcr.io/zyvorai/guestkit-mcp:1.2.9
```

### Codex

**Командой платформы**
```bash
codex mcp add guestkit -- docker run -i --rm ghcr.io/zyvorai/guestkit-mcp:1.2.9
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "guestkit": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/zyvorai/guestkit-mcp:1.2.9"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "guestkit": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/zyvorai/guestkit-mcp:1.2.9"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add guestkit docker run -i --rm ghcr.io/zyvorai/guestkit-mcp:1.2.9
```

## Когда брать
- проверить готовность образа к первому запуску
- найти причины блокировки загрузки виртуальной машины
- сформировать план исправлений для диска
- подготовить проверку миграции в CI
- зафиксировать результат проверки в Cutover Passport

## Примеры запросов агенту
- Проверь образ `vm.qcow2` офлайн и объясни, что мешает его первой загрузке.
- Оцени готовность `server.vmdk` к миграции и составь план исправлений.
- Сформируй отчёт по образу `legacy.raw` с результатом проверки для CI.

## Похожие
- [disk-forensics](https://affpapa.org/nevibecode/skills/disk-forensics.md) — скилл · 357 установок
- [kernel-exploitation](https://affpapa.org/nevibecode/skills/kernel-exploitation.md) — скилл · 3600 установок
- [cross-gcc](https://affpapa.org/nevibecode/skills/cross-gcc.md) — скилл · 682 установки
- [qemu-for-kernel-development](https://affpapa.org/nevibecode/skills/qemu-for-kernel-development.md) — скилл · 319 установок
- [mcp-proxmox](https://affpapa.org/nevibecode/mcp/mcp-proxmox.md) — MCP-сервер · ★ 17
- [app-marketplace-review](https://affpapa.org/nevibecode/skills/app-marketplace-review.md) — скилл · 8100 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md