analyze_mesh_geometry
Read-only
Analyze 3D mesh geometry to spot printability issues before slicing: volume, surface area, overhangs, connected components, degenerate triangles, and a mesh check score.
Instructions
Deep geometric and printability analysis of a 3D mesh.
Goes beyond basic validation to compute volume, surface area,
center of mass, overhang detection, connected components (floating
parts), degenerate triangles, and ``mesh_check_score`` (0-100), a
quick mesh check. It is not the printability score: call
``analyze_printability`` for that grade.
Use this after generating a model to understand its geometry and
identify printability issues before sending to the slicer.
For a STEP/STP CAD file this converts it first and every metric
below is measured on Kiln's mesh copy — except an added ``exact``
block, which carries the volume, surface area and envelope read
from the CAD file's own surfaces. Those two disagree slightly
and the exact ones are the part's: quote ``exact`` when telling
a user how big their CAD part is. ``mesh_quality_scorecard``
gives the same file a fuller intake report.
A mesh of more than one body also gets ``body_pairs``: for each
pair of bodies, nearest first, the smallest gap between them in
mm and, where two overlap, the volume they share (they print
fused). It is what a print-in-place part (gears in a ring, a
pin in its knuckles) is designed against. Bodies are numbered
as the fusion findings number them, and each one's centre, box
and volume say which part it is.
:param file_path: Path to a mesh (.stl, .obj, .glb, .3mf) or a CAD
file (.step, .stp), which is converted automatically.
:returns: Dict with full mesh analysis metrics, plus ``exact``
for CAD input and ``body_pairs`` for a mesh of several bodies.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_path": "<file_path>"
},
"name": "analyze_mesh_geometry"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Path to a mesh (.stl, .obj, .glb, .3mf) or a CAD file (.step, .stp), which is converted automatically. |