cad-mcp-server

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • process.env — Environment variable access in .github/workflows/ci.yml
  • fs module — File system access in .github/workflows/ci.yml
  • process.env — Environment variable access in .github/workflows/release-please.yml
  • spawnSync — Synchronous process spawning in eval/runner/config.ts
  • process.env — Environment variable access in eval/runner/config.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

MCP server for AI-assisted STEP CAD inspection, geometry queries, PMI hints, and revision comparison

README.md

CAD MCP Server

npm version
npm downloads

Give any MCP host deterministic geometry intelligence for 3D CAD models. Drop in a STEP file, inspect and measure it, and compare revisions. Runs entirely on your machine — no cloud, no CAD license, no setup.

cad-mcp is a standalone fact server. It does not decide design intent or claim manufacturability. Specialized hosts and domain servers can use its structured results as evidence for DFM, materials, electronics integration, FEA, proposals, and other workflows.

Quick Start

npx -y cad-mcp-server

Add to your MCP client:

{
  "mcpServers": {
    "cad": {
      "command": "npx",
      "args": ["-y", "cad-mcp-server"]
    }
  }
}

Point your MCP host at any STEP file and ask questions like:

"Inspect this part. Measure wall thickness, draft angles, and hole sizes, and report the measured facts with limitations."

Why Engineers Use It

  • Zero setup. One command. No CAD software, licenses, Docker, or cloud API.
  • Runs locally. Your STEP files never leave your machine.
  • Deterministic answers. Backed by the Open CASCADE kernel, not LLM guessing.
  • Read-only. Inspects geometry without modifying anything.

What It Can Do

Tool Example question
inspect "What are the overall dimensions and volume?"
find_entities "Find all cylindrical faces. Which ones are holes vs bosses?"
find_entities "Select the faces on the wheel-axle component."
measure "What's the clearance between this hole and the nearest wall?"
measure "Check wall thickness around every hole. Flag anything below 2mm."
measure "Does this part have sufficient draft for a +Z mold pull?"
diff "What changed between revision A and revision B?"

The measure tool selects the measurement with kind (distance, thickness, draft, ray, ray_grid, point_analysis, section, continuity).

The host or a domain capability interprets the measurements. You get structured engineering facts rather than unsupported guesses.

Example Prompts

  • "Review this part for injection molding: check draft angles with +Z pull, measure minimum wall thickness, identify undercuts."
  • "Prepare a first-pass CNC plan: likely setups, drilling directions, features that drive cost."
  • "Compare these two revisions and flag what needs rechecking before tooling."
  • "Which holes are blind vs through? What's the depth of the blind hole?"
  • "Find the thinnest wall section on this part. Is it above the 1.5mm minimum?"

See docs/EXAMPLE_PROMPTS.md for more.

Requirements

  • Node.js 24+
  • STEP files (export from SolidWorks, FreeCAD, Fusion 360, CATIA, or any CAD system)

License

MIT. The bundled OCCT kernel uses LGPL-2.1. See THIRD_PARTY_NOTICES.md.

Reviews (0)

No results found