@shapeitup/mcp-server

MCP server for ShapeItUp — scripted CAD tools (Replicad / OpenCascade WASM) for Claude Code, Cursor, Claude Desktop, Gemini CLI, Mistral Vibe, and any stdio MCP client. Fully headless, no VSCode required.

Install

Don't — just point your MCP client at it:

npx -y @shapeitup/mcp-server

Claude Code

claude mcp add shapeitup -- npx -y @shapeitup/mcp-server

Cursor / Claude Desktop / generic MCP client

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

• Cursor: ~/.cursor/mcp.json (or Settings → MCP)
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows)

Mistral Vibe

Append to ~/.vibe/config.toml (the CLI and the VS Code extension share it), then run /reload in Vibe:

[[mcp_servers]]
name = "shapeitup"
transport = "stdio"
command = "npx"
args = ["-y", "@shapeitup/mcp-server"]
startup_timeout_sec = 60

Or have Vibe write it for you:

vibe mcp add shapeitup --transport stdio --command npx --arg=-y --arg=@shapeitup/mcp-server --startup-timeout-sec 60

Keep startup_timeout_sec. Vibe's default is 10 s, and the first run of npx downloads the package, which can take longer than that. The tools show up as shapeitup_create_shape, shapeitup_render_preview and so on.

For the Replicad API reference, save SKILL.md as ~/.vibe/skills/shapeitup/SKILL.md. Vibe loads it as-is, and it also becomes the /shapeitup command. With the VS Code extension installed, ShapeItUp: Install MCP Server… → Add to Mistral Vibe does both steps after you confirm.

Node 20+ required. Works in Docker / CI (WASM, no native deps).

What's in the box

29 MCP tools covering the full CAD loop:

• Authoring — create_shape, modify_shape, read_shape, delete_shape, list_shapes, setup_shape_project, get_api_reference
• Rendering — render_preview, preview_shape, get_preview, set_render_mode, toggle_dimensions, open_viewer, close_viewer
• Verification — verify_shape, check_collisions, check_stack, sweep_check, run_simulation, describe_geometry, validate_joints, validate_syntax
• Iteration — tune_params, clear_params, get_render_status
• Export & open — export_shape (STEP / STL / 3MF), open_shape, list_installed_apps, preview_finder
• Plus the shapeitup stdlib (holes, screws/bolts/washers/inserts, bearings, extrusions, patterns, threads, joints, assembly, printHints) importable from any .shape.ts.

More

Full docs, architecture notes, and the optional VSCode live-viewer extension live in the monorepo README.

License

MIT