Vérifier la printabilité d'un modèle
check_printabilityAnalyze 3D models (STL/3MF) to detect printing issues like thin walls, long bridges, overhangs, and mesh problems. Provides a printability score and recommendations for successful prints.
Instructions
Analyse un modèle 3D (STL/3MF) pour détecter les problèmes d'impression : murs trop fins, ponts trop longs, overhangs, mesh non-manifold, stabilité, etc. Retourne un score de printabilité et des recommandations.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Chemin absolu vers le fichier STL ou 3MF | |
| nozzle_diameter | No | Diamètre de buse en mm (pour calibrer les seuils) |
Implementation Reference
- src/tools/check-printability.ts:25-110 (handler)The main handler function that executes the check_printability tool. It validates the file exists, parses the 3D model, analyzes the mesh, detects print issues, and returns a formatted report with printability score, issues categorized by severity (error/warning/info), and Bible FDM diagnostic hints.
async ({ file_path, nozzle_diameter }) => { try { if (!existsSync(file_path)) { return { isError: true, content: [{ type: "text" as const, text: `Fichier non trouvé : ${file_path}` }], }; } console.error(`[check_printability] Analyzing ${file_path}...`); const mesh = await parseModel(file_path); const analysis = analyzeMesh(mesh); const report = detectPrintIssues(mesh.triangles, analysis, nozzle_diameter); const lines: string[] = [ `## Rapport de printabilité`, `**Score** : ${report.score}/100`, `**Verdict** : ${report.summary}`, `**Buse** : ${nozzle_diameter}mm`, "", ]; if (report.issues.length === 0) { lines.push("Aucun problème détecté. La pièce est prête à imprimer."); } else { // Group by severity const errors = report.issues.filter((i) => i.severity === "error"); const warnings = report.issues.filter((i) => i.severity === "warning"); const infos = report.issues.filter((i) => i.severity === "info"); if (errors.length > 0) { lines.push("### Erreurs critiques"); for (const issue of errors) { lines.push(`- **[${issue.category}]** ${issue.message}`); if (issue.detail) lines.push(` _${issue.detail}_`); } lines.push(""); } if (warnings.length > 0) { lines.push("### Avertissements"); for (const issue of warnings) { lines.push(`- **[${issue.category}]** ${issue.message}`); if (issue.detail) lines.push(` _${issue.detail}_`); } lines.push(""); } if (infos.length > 0) { lines.push("### Informations"); for (const issue of infos) { lines.push(`- **[${issue.category}]** ${issue.message}`); if (issue.detail) lines.push(` _${issue.detail}_`); if (issue.bibleFdmRef) lines.push(` _Bible FDM: ${issue.bibleFdmRef}_`); } } } // Bible FDM diagnostic hints if (report.diagnosticHints && report.diagnosticHints.length > 0) { lines.push(""); lines.push("### Diagnostic Bible FDM"); for (const hint of report.diagnosticHints) { lines.push(`**${hint.defect}**`); lines.push(` Causes probables : ${hint.causes.join(", ")}`); lines.push(` Actions recommandées :`); for (const fix of hint.fixes) { lines.push(` - ${fix}`); } lines.push(""); } } return { content: [{ type: "text" as const, text: lines.join("\n") }], }; } catch (error) { return { isError: true, content: [{ type: "text" as const, text: `Erreur : ${error instanceof Error ? error.message : String(error)}`, }], }; } }, - Input schema definition using Zod. Defines two parameters: 'file_path' (string, absolute path to STL/3MF file) and 'nozzle_diameter' (number, defaults to 0.4mm) used to calibrate detection thresholds.
inputSchema: { file_path: z.string().describe("Chemin absolu vers le fichier STL ou 3MF"), nozzle_diameter: z .number() .default(0.4) .describe("Diamètre de buse en mm (pour calibrer les seuils)"), }, - src/tools/check-printability.ts:8-112 (registration)The registerCheckPrintability function that registers the tool with the MCP server. Includes tool metadata (title, description), input schema, and the handler function.
export function registerCheckPrintability(server: McpServer) { server.registerTool( "check_printability", { title: "Vérifier la printabilité d'un modèle", description: "Analyse un modèle 3D (STL/3MF) pour détecter les problèmes d'impression : " + "murs trop fins, ponts trop longs, overhangs, mesh non-manifold, stabilité, etc. " + "Retourne un score de printabilité et des recommandations.", inputSchema: { file_path: z.string().describe("Chemin absolu vers le fichier STL ou 3MF"), nozzle_diameter: z .number() .default(0.4) .describe("Diamètre de buse en mm (pour calibrer les seuils)"), }, }, async ({ file_path, nozzle_diameter }) => { try { if (!existsSync(file_path)) { return { isError: true, content: [{ type: "text" as const, text: `Fichier non trouvé : ${file_path}` }], }; } console.error(`[check_printability] Analyzing ${file_path}...`); const mesh = await parseModel(file_path); const analysis = analyzeMesh(mesh); const report = detectPrintIssues(mesh.triangles, analysis, nozzle_diameter); const lines: string[] = [ `## Rapport de printabilité`, `**Score** : ${report.score}/100`, `**Verdict** : ${report.summary}`, `**Buse** : ${nozzle_diameter}mm`, "", ]; if (report.issues.length === 0) { lines.push("Aucun problème détecté. La pièce est prête à imprimer."); } else { // Group by severity const errors = report.issues.filter((i) => i.severity === "error"); const warnings = report.issues.filter((i) => i.severity === "warning"); const infos = report.issues.filter((i) => i.severity === "info"); if (errors.length > 0) { lines.push("### Erreurs critiques"); for (const issue of errors) { lines.push(`- **[${issue.category}]** ${issue.message}`); if (issue.detail) lines.push(` _${issue.detail}_`); } lines.push(""); } if (warnings.length > 0) { lines.push("### Avertissements"); for (const issue of warnings) { lines.push(`- **[${issue.category}]** ${issue.message}`); if (issue.detail) lines.push(` _${issue.detail}_`); } lines.push(""); } if (infos.length > 0) { lines.push("### Informations"); for (const issue of infos) { lines.push(`- **[${issue.category}]** ${issue.message}`); if (issue.detail) lines.push(` _${issue.detail}_`); if (issue.bibleFdmRef) lines.push(` _Bible FDM: ${issue.bibleFdmRef}_`); } } } // Bible FDM diagnostic hints if (report.diagnosticHints && report.diagnosticHints.length > 0) { lines.push(""); lines.push("### Diagnostic Bible FDM"); for (const hint of report.diagnosticHints) { lines.push(`**${hint.defect}**`); lines.push(` Causes probables : ${hint.causes.join(", ")}`); lines.push(` Actions recommandées :`); for (const fix of hint.fixes) { lines.push(` - ${fix}`); } lines.push(""); } } return { content: [{ type: "text" as const, text: lines.join("\n") }], }; } catch (error) { return { isError: true, content: [{ type: "text" as const, text: `Erreur : ${error instanceof Error ? error.message : String(error)}`, }], }; } }, ); } - src/index.ts:14-14 (registration)Import statement for registerCheckPrintability in the main server file.
import { registerCheckPrintability } from "./tools/check-printability.js"; - src/index.ts:43-43 (registration)Registration call that activates the check_printability tool on the MCP server instance.
registerCheckPrintability(server);