Minecraft Schematic Lab

Build Minecraft schematics by talking to Claude. Describe what you want and it produces a WorldEdit Sponge .schem with a live 3D preview in the browser. Everything runs locally — no account, no cloud.

Setup

You need Node 22+ and Claude Code (CLI or desktop app). Add the connector once — either way below works for both the CLI and the desktop app, since they share the same config.

claude mcp add --scope user minecraft-schematic-lab -- npx -y github:SimoneRecchia/minecraft-schematic-lab --mcp

claude mcp add --scope user minecraft-schematic-lab -- cmd /c npx -y github:SimoneRecchia/minecraft-schematic-lab --mcp

{
  "mcpServers": {
    "minecraft-schematic-lab": {
      "command": "npx",
      "args": ["-y", "github:SimoneRecchia/minecraft-schematic-lab", "--mcp"]
    }
  }
}

{
  "mcpServers": {
    "minecraft-schematic-lab": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "github:SimoneRecchia/minecraft-schematic-lab", "--mcp"]
    }
  }
}

Restart Claude Code so it picks up the connector, then ask:

build me a 50×40×80 fantasy castle

The first run pulls the tool through npx; the 3D preview then opens at http://127.0.0.1:8765.

Using it

• Change it — "make the roof brick", "add two towers". The preview refreshes on its own.
• Export — the Export .schem button in the browser, or ask Claude (Sponge v2, or v3).
• In Minecraft — put the .schem in your world's schematics folder, then //schem load <name> and //paste.
• Versions — ask Claude to version a build in a folder (needs git).
• Updates — the connector follows main; pin a release with #v0.1.0, or clear a stale cache with npm cache clean --force.

Platform support

Node 22+ on every platform; 32-bit isn't supported.

Develop

pnpm setup        # install + build
pnpm dev          # web (5173) + server (8765), hot reload
pnpm test         # vitest
pnpm bundle       # rebuild bundle/ for the npx connector (commit after server changes)

Architecture, MCP tools, the HTTP API and the BuildSpec format are documented in CLAUDE.md.

License

MIT © 2026 SimoneRecchia