io.github.AlexikM/gibil

Official

Spawns an ephemeral Ubuntu VM with project clone, shell exec, file I/O, and auto-destroy on TTL.

Spawns ephemeral Ubuntu VMs with project clone, shell execution, and auto-cleanup.

Install

Configuration

Environment variables

HETZNER_API_TOKENsecret

Required when targeting Hetzner. Get from console.hetzner.com > Security > API Tokens.

VULTR_API_KEYsecret

Required when targeting Vultr. Get from my.vultr.com > Account > API. At least one provider token is required.

GITHUB_TOKENsecret

Optional. Used to clone private GitHub repos into the VM at boot via cloud-init.

GIBIL_API_KEYsecret

Optional. Authenticates against gibil.dev for usage tracking and paid plans.

Arguments

subcommandrequireddefault mcp

claude_desktop_config.json

{
  "mcpServers": {
    "gibil": {
      "command": "npx",
      "args": [
        "-y",
        "gibil@0.5.1"
      ],
      "env": {
        "HETZNER_API_TOKEN": "<YOUR_HETZNER_API_TOKEN>",
        "VULTR_API_KEY": "<YOUR_VULTR_API_KEY>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "GIBIL_API_KEY": "<YOUR_GIBIL_API_KEY>"
      }
    }
  }
}