@animbox/mcp

A small local bridge that lets your AI assistant drive your own open AnimBox tab.

AnimBox runs in the browser — your scene, materials, and documents live in the tab. This package runs a tiny local process on your machine that connects your MCP client (such as a desktop AI assistant or a coding tool) to the AnimBox tab you already have open, so the assistant can build, verify, and iterate on 3D models with a structured result on every script run.

Quick start

Add the bridge to your MCP client configuration:

{
  "mcpServers": {
    "ab": {
      "command": "npx",
      "args": ["-y", "@animbox/mcp"]
    }
  }
}

Windows: many MCP clients cannot spawn bare npx (it is npx.cmd on Windows and fails with ENOENT). Use the wrapper form instead:

{
  "mcpServers": {
    "ab": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@animbox/mcp"]
    }
  }
}

No global install needed — the client starts the bridge on demand.

Pair with your AnimBox tab

1. Start (or restart) your AI client so the bridge launches. It prints a short pairing code in its terminal output.
2. Open https://www.anim-box.com/editor in Chrome, Edge, or Firefox.
3. Open Settings → Local AI Bridge, turn the bridge ON, and paste the pairing code.
4. The first connection may show a browser prompt asking to allow access to the local network — click Allow, then retry. This happens once per browser profile.

The full guide (requirements, troubleshooting): https://www.anim-box.com/mcp

Browser support: Chrome, Edge, and Firefox on desktop. Safari and iOS are not supported — the app shows a message asking you to switch browsers.

What it gives the assistant

• 14 tools — run_script runs an AnimBox script in the connected tab and returns a structured result (a verdict, the checks that ran, warnings, and remediation guidance); verify_geometry runs structural checks; capture_screenshot returns viewport images (up to 4 orbit angles); inspect_scene, route_intent, open_design_ledger, list_api, get_help, recipes, diagnose_failure, switch_editor, report_bug, pairing_code — and bridge_status, which reports the connection state instantly with no tab needed (call it first when anything times out). Reference scene objects by name, not by id.
• 7 guided skills (MCP prompts) — help, connect, learn-animbox (builds a local .animbox knowledge cache), create-plan, execute-plan, quick-build (small single-pass asks), report-bug: plan a build first, then execute it task by task with verification after every step.
• Live documentation resources — fetched from the AnimBox site on demand, so guidance is always current; no re-install when AnimBox ships features.

Security

• Binds to 127.0.0.1 only — nothing is exposed to your network.
• Off by default in the app; nothing runs until you opt in via Settings.
• A fresh pairing code is required each time the bridge restarts.
• Only one AnimBox tab can be connected at a time.