@obenor/mcp

Build parametric solid models in Obenor3D from an MCP client — Codex, Claude Code, or anything else that speaks the protocol.

codex mcp add obenor3d --env OBENOR_LINK=<token> -- npx -y @obenor/mcp

<token> is the eight characters after /s/ in an Edit share link. Make one from the Share sheet in the app; the sheet also writes this line out for you, with the token already in it.

What it is

A full B-rep modelling kernel, driven as MCP tools: sketches, extrudes, booleans, fillets, sheet metal, surfacing, drawings, materials and offscreen renders. It edits the same document the browser has open, so a model built here appears on screen as it is built, and edits made on screen are adopted before the next tool runs.

The kernel is fetched, not shipped

The geometry kernel is 24 MB of WebAssembly. Rather than put it in the tarball, the first run fetches it from the deployment you are connected to — by content hash, into ~/.obenor/kernel — and every run after that is instant. npx is therefore a ~800 kB download rather than a 50 MB one, and a new kernel does not need a new release of this package.

Point OBENOR_ORIGIN at your own deployment if you are not using https://3d.obenor.com; the kernel comes from wherever the app does.

Hosted alternative

If you would rather install nothing at all, the app also speaks MCP over HTTP:

codex mcp add obenor3d --url https://3d.obenor.com/api/agent/mcp --bearer-token <token>

That runs every tool in the browser tab that has the model open, so the model has to be open — and it cannot read files on your machine. This package can do both: it works with no browser running, and it can read the blueprint sitting in your downloads folder.

Environment

| | | |---|---| | OBENOR_LINK | Edit share-link token. Required to mirror a model. | | OBENOR_ORIGIN | Defaults to https://3d.obenor.com. | | OBENOR_KERNEL_CACHE | Defaults to ~/.obenor/kernel. | | OBENOR_BAKE | 0 to stop baking meshes and a poster on publish. |