@classcad/mcp 0.1.0

package/dist/tools/snapshot.js

@@ -0,0 +1,174 @@
+// snapshot — render the current drawing and return it as an inline PNG image
+// block plus the on-disk path.
+//
+// Rendering comes from @classcad/renderer (the shared engine) — this tool
+// exposes its full verification toolkit: named views AND arbitrary cameras,
+// section planes, four-view sheets, native/distinct colors, highlight ids,
+// probe markers, sketch overlay, annotations, x-ray, frame pinning, layers.
+//
+// The PNG is also persisted under
+//   $CLASSCAD_SNAPSHOT_DIR (env override) — or
+//   <os.tmpdir()>/classcad-snapshots/                — default
+// so the user can open it later. Files are NOT auto-cleaned.
+import { z } from 'zod';
+import { mkdirSync, readFileSync } from 'fs';
+import { isAbsolute, join, resolve } from 'path';
+import { tmpdir } from 'os';
+import { renderSession } from '@classcad/renderer/node';
+function snapshotDir(outDir) {
+    const envDir = outDir ?? process.env.CLASSCAD_SNAPSHOT_DIR;
+    const dir = envDir ? resolve(envDir) : join(tmpdir(), 'classcad-snapshots');
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function timestamp() {
+    // 2026-05-01T12-34-56Z — filesystem-safe ISO basic format
+    return new Date().toISOString().replace(/[:.]/g, '-').replace(/-\d+Z$/, 'Z');
+}
+const viewSchema = z.union([
+    z.enum(['iso', 'top', 'bottom', 'front', 'back', 'left', 'right']),
+    z.object({ azimuth: z.number().optional(), elevation: z.number().optional() })
+        .describe('Turntable camera in DEGREES (Z-up): azimuth 0 = front, 90 = camera at +X; elevation 0 = horizon, 90 = top.'),
+    z.object({ direction: z.array(z.number()).length(3), up: z.array(z.number()).length(3).optional() })
+        .describe('Explicit orthographic look direction (from camera toward the scene).'),
+]);
+export function registerSnapshotTool(server, client) {
+    server.registerTool('snapshot', {
+        title: 'Snapshot drawing',
+        description: 'Render the current drawing as an inline PNG (also written to disk: outDir, else $CLASSCAD_SNAPSHOT_DIR, else <tmpdir>/classcad-snapshots). ' +
+            'The image is returned to the MODEL as an inline image block — no follow-up Read is needed to see it. ' +
+            'The USER may not see tool results (Claude Code / desktop Code tab do not render them): ' +
+            'send the saved PNG path through the host\'s file-sending tool (e.g. SendUserFile) if the user should see the render. ' +
+            'Hosts preview only files inside the session\'s own folders (Claude Code: the scratchpad directory or the project) — anywhere else the user gets a grey placeholder card. ' +
+            'So when you intend to send the render, pass outDir = your scratchpad directory (or a folder in the project). ' +
+            'Call after a meaningful geometry change, NOT after every parameter tweak. ' +
+            'Verification options: section (cut through internals), sheet (four labeled views, shared ortho scale), ' +
+            'drawing (technical drawing: front/top/side with hidden lines dashed, placed first- or third-angle — compare against a reference drawing), ' +
+            'lines (line style: visible edges solid, hidden dashed), ' +
+            'highlight (face/edge/body ids in signal color), markers (probe crosshairs at world points), ' +
+            'sketchOverlay (sketch curves on their real plane), annotate (extents + axes triad + scale bar), ' +
+            'xray (hidden geometry shines through), colors "distinct" (one color per body — booleans/splits/patterns), ' +
+            'frame (pin an earlier snapshot\'s reported frame for pixel-comparable before/after).',
+        inputSchema: {
+            label: z.string().optional().describe('Filename label. Default "snapshot".'),
+            outDir: z
+                .string()
+                .optional()
+                .describe('Absolute directory for the PNG (created if missing). Pass your session scratchpad when the user should see the file — hosts preview only files in session folders.'),
+            width: z.number().int().min(64).max(4096).optional().describe('Pixels (default 1200).'),
+            height: z.number().int().min(64).max(4096).optional().describe('Pixels (default 900).'),
+            supersample: z.number().int().min(1).max(4).optional()
+                .describe('Anti-aliasing: render at k× and downscale to width×height (default 2; 1 = raw aliased pixels). Output size and image tokens are unchanged.'),
+            view: viewSchema.optional().describe('Camera: named view (default "iso") or arbitrary orthographic camera.'),
+            zoom: z.number().min(0.05).max(50).optional()
+                .describe('Multiplier on auto-fit scale. 1=fit-all (default), >1 zooms in.'),
+            lookAt: z.array(z.number()).length(3).optional()
+                .describe('World-space [x,y,z] that lands at screen center. Omit for bbox center.'),
+            layers: z.array(z.enum(['solid', 'sketch', 'curves', 'workgeo'])).optional()
+                .describe('Content layers to render. Default ["solid"].'),
+            colors: z.enum(['native', 'distinct']).optional()
+                .describe('"native" (default): the model\'s own colors. "distinct": one palette color per body.'),
+            section: z.object({
+                origin: z.array(z.number()).length(3),
+                normal: z.array(z.number()).length(3),
+                cap: z.boolean().optional(),
+            }).optional().describe('Cut the solids at a plane; the positive side of the normal is removed. The cut faces are filled and hatched like a drawing\'s section (wall thicknesses, bores and pockets read directly); cap: false leaves the cut open with interior walls shaded. Combine with drawing for a section view.'),
+            sheet: z.union([z.boolean(), z.array(viewSchema).length(4), z.array(viewSchema).length(2)]).optional()
+                .describe('Multi-view sheet in ONE image. true or 4 views = quadrants (default top/iso/front/right; ortho views share one scale). 2 views = side-by-side panels labeled A | B — use for the mirror check: [matched view, same view with negated azimuth] in a single render.'),
+            lines: z.boolean().optional()
+                .describe('Line style instead of shading: visible edges and silhouettes solid, hidden edges dashed. Hidden lines show bores, pockets, hollow vs solid. Works for the single view and every sheet panel.'),
+            drawing: z.union([
+                z.boolean(),
+                z.enum(['first-angle', 'third-angle']),
+                z.object({
+                    projection: z.enum(['first-angle', 'third-angle']).optional(),
+                    side: z.enum(['left', 'right']).optional(),
+                    iso: z.boolean().optional(),
+                }),
+            ]).optional()
+                .describe('Technical drawing in ONE image: front, top and side view in line style (hidden edges dashed), aligned at one scale, plus a shaded iso. "first-angle" (ISO E, Europe; true): top view BELOW front, view from the left RIGHT of it. "third-angle" (ISO A, US): top view ABOVE front, view from the right RIGHT of it. Use the method of the reference drawing, then compare view by view. Takes precedence over sheet.'),
+            highlight: z.array(z.number()).optional()
+                .describe('Ids rendered in signal color: graphic container ids, owning solid ids, face mesh ids, edge ids. CAUTION: face/edge ids are only stable within one graphic payload (recalc reassigns them) — across tool calls use highlightAt.'),
+            highlightAt: z.array(z.array(z.number()).length(3)).optional()
+                .describe('World points [[x,y,z],…]: the closest FACE in the rendered payload is highlighted per point. Geometrically anchored — the robust way to highlight a face found via run_script (return a point on it, not its mesh id).'),
+            markers: z.array(z.object({
+                position: z.array(z.number()).length(3),
+                label: z.string().optional(),
+                color: z.array(z.number()).length(3).optional(),
+            })).optional().describe('Probe markers (crosshair + label) at world coordinates, drawn on top.'),
+            sketchOverlay: z.boolean().optional()
+                .describe('Draw sketch curves in 3D on their actual plane over the solid render.'),
+            annotate: z.boolean().optional()
+                .describe('Measurement overlay: bbox extents, view-oriented axes triad, scale bar.'),
+            xray: z.boolean().optional().describe('Translucent bodies — hidden geometry shines through.'),
+            frame: z.object({ scale: z.number(), midX: z.number(), midY: z.number() }).optional()
+                .describe('Pin the frame reported by an earlier snapshot (same view/size) for pixel-comparable before/after.'),
+            recalc: z.boolean().optional()
+                .describe('Default false. Opt in only to regenerate; keep false for solid.*/entity-injection sessions — recalc destroys injected bodies.'),
+            source: z.enum(['graphic', 'stl']).optional()
+                .describe('"stl": render the tessellated STL export instead of the engine graphic (explicit fallback; no brep edges).'),
+        },
+    }, async (input) => {
+        const { label, outDir, ...options } = input;
+        const safeLabel = (label ?? 'snapshot').replace(/[^a-zA-Z0-9_-]/g, '_');
+        if (outDir !== undefined && !isAbsolute(outDir)) {
+            return { content: [{ type: 'text', text: `outDir must be an absolute path (the daemon's working directory is not yours): ${outDir}` }], isError: true };
+        }
+        const dir = snapshotDir(outDir);
+        const prefix = `${safeLabel}-${timestamp()}`;
+        let renders;
+        try {
+            renders = await renderSession(client, prefix, dir, {
+                width: options.width ?? 1200,
+                height: options.height ?? 900,
+                supersample: options.supersample ?? 2,
+                vectorText: true,
+                ...options,
+                layers: options.layers ?? ['solid'],
+            });
+        }
+        catch (e) {
+            // renderSession fails LOUDLY with cause + remedies (e.g. no graphic
+            // data → suggests source: "stl"). Surface that verbatim to the model.
+            return { isError: true, content: [{ type: 'text', text: e instanceof Error ? e.message : String(e) }] };
+        }
+        const imageBlocks = [];
+        const paths = [];
+        for (const r of renders) {
+            const fullPath = join(dir, r.file);
+            try {
+                const buf = readFileSync(fullPath);
+                imageBlocks.push({ type: 'image', data: buf.toString('base64'), mimeType: 'image/png' });
+                paths.push(fullPath);
+            }
+            catch {
+                /* skip files that didn't materialize */
+            }
+        }
+        if (imageBlocks.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: 'No renderable content. Add geometry first (a part, sketch, or feature) and try again.',
+                    }],
+            };
+        }
+        // Inline image first (what the MODEL sees), then the path note — with a reminder
+        // that the user may not see tool-result images — and, when available, the
+        // frame, so a later snapshot can pin it (before/after).
+        const noteLines = [paths.length === 1 ? `Saved: ${paths[0]}` : `Saved:\n${paths.join('\n')}`];
+        noteLines.push(`capture: ${JSON.stringify(renders[0]?.metadata)}`);
+        const framed = renders.find(r => r.frame);
+        if (framed && framed.frame)
+            noteLines.push(`frame: ${JSON.stringify(framed.frame)}`);
+        noteLines.push('Note: the user may not see this image in their transcript — send the saved file via the host\'s file-sending tool (e.g. SendUserFile) if they should see it.' +
+            (outDir ? '' : ' Hosts preview only files in session folders: re-run with outDir = your scratchpad before sending, or the user sees a grey placeholder.'));
+        return {
+            content: [
+                ...imageBlocks,
+                { type: 'text', text: noteLines.join('\n') },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/tools/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/tools/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/tools/state.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Client } from '../client.js';
+export declare function registerStateTools(server: McpServer, client: Client): void;

package/dist/tools/state.js

@@ -0,0 +1,95 @@
+// State tools: tree, find, inspect.
+//
+// Read-only access to the cached structure tree. The cache is updated as a
+// side effect of any API call (server sends a full snapshot on every Result
+// frame), so these tools never trigger a server round-trip unless `refresh`
+// is requested.
+import { z } from 'zod';
+function slim(n) {
+    const out = { id: n.id, class: n.class, name: n.name };
+    if (n.parent != null)
+        out.parent = n.parent;
+    return out;
+}
+export function registerStateTools(server, client) {
+    server.registerTool('tree', {
+        title: 'Structure tree',
+        description: 'Return the cached drawing structure tree. Pass refresh=true to force a fresh server fetch first.',
+        inputSchema: {
+            refresh: z.boolean().optional().describe('Force a server round-trip before reading the cache.'),
+        },
+    }, async ({ refresh }) => {
+        // Pulls when the cache is stale (or `refresh`), then the structure is current.
+        await client.getTree({ refresh });
+        const t = client.getStructure();
+        if (!t) {
+            return { content: [{ type: 'text', text: JSON.stringify({ tree: null, hint: 'No structure cached yet — make any API call first, or pass refresh=true.' }) }] };
+        }
+        const nodes = Object.values(t.tree);
+        const summary = {
+            root: t.root,
+            currentProduct: t.currentProduct,
+            currentInstance: t.currentInstance,
+            nodeCount: nodes.length,
+            nodes: nodes.map(slim),
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(summary) }] };
+    });
+    server.registerTool('find', {
+        title: 'Find nodes',
+        description: 'Search the cached structure tree by class and/or name substring. Returns slim records (id, class, name, parent).',
+        inputSchema: {
+            type: z.string().optional().describe('Match nodes whose class === type (e.g. "CC_Part", "CC_Box").'),
+            name: z.string().optional().describe('Match nodes whose name contains this substring (case-insensitive).'),
+            refresh: z.boolean().optional(),
+        },
+    }, async ({ type, name, refresh }) => {
+        // Pulls when the cache is stale (or `refresh`), then the structure is current.
+        await client.getTree({ refresh });
+        const t = client.getStructure();
+        if (!t)
+            return { content: [{ type: 'text', text: '[]' }] };
+        const needle = name?.toLowerCase();
+        const hits = Object.values(t.tree).filter(n => {
+            if (type && n.class !== type)
+                return false;
+            if (needle && !String(n.name ?? '').toLowerCase().includes(needle))
+                return false;
+            return true;
+        });
+        return { content: [{ type: 'text', text: JSON.stringify({ count: hits.length, nodes: hits.map(slim) }) }] };
+    });
+    server.registerTool('inspect', {
+        title: 'Inspect node',
+        description: 'Return the full record for a single tree node by ID, including members and children.',
+        inputSchema: {
+            id: z.union([z.string(), z.number()]).describe('Node ID.'),
+            refresh: z.boolean().optional(),
+        },
+    }, async ({ id, refresh }) => {
+        // Pulls when the cache is stale (or `refresh`), then the structure is current.
+        await client.getTree({ refresh });
+        const t = client.getStructure();
+        const node = t?.tree[String(id)] ?? null;
+        if (!node) {
+            return { content: [{ type: 'text', text: JSON.stringify({ id, found: false }) }] };
+        }
+        // Include parent chain for orientation.
+        const chain = [];
+        let cur = node;
+        while (cur && cur.parent != null) {
+            const p = t.tree[String(cur.parent)];
+            if (!p)
+                break;
+            chain.push({ id: p.id, class: p.class, name: p.name });
+            cur = p;
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ found: true, node, parentChain: chain }),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=state.js.map

package/dist/tools/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/tools/state.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+export type Id = number | string;
+export type Message = {
+    message: string;
+    level: number;
+    code: number;
+    api: string;
+};
+export type StructureNode = {
+    id: Id;
+    class: string;
+    name: string;
+    parent: Id | null;
+    flags: number;
+    children?: Id[];
+    members?: Record<string, {
+        value: unknown;
+        type: string;
+        visible: number;
+        expression: string;
+    }>;
+    [key: string]: unknown;
+};
+export type Structure = {
+    root: Id;
+    currentProduct: Id;
+    currentInstance: Id;
+    testRoot: Id;
+    tree: Record<string, StructureNode>;
+};
+export type GraphicContainer = {
+    id: Id;
+    type: number;
+    [key: string]: unknown;
+};
+export type Graphic = {
+    containers?: GraphicContainer[];
+    properties?: unknown;
+    [key: string]: unknown;
+};
+export type ApiResult<T = unknown> = {
+    result: T;
+    messages: Message[];
+    maxLevel: number;
+    structure: Structure | null;
+    graphic: Graphic | null;
+};

package/dist/types.js

@@ -0,0 +1,3 @@
+// Shared types for the ClassCAD WS protocol.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6CAA6C"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@classcad/mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for the ClassCAD CAD engine",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "classcad-mcp": "dist/server.js"
+  },
+  "main": "dist/server.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/copy-build-assets.mjs",
+    "dev": "tsc --watch",
+    "start": "node dist/server.js",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "postbuild": "node --test test/emission.mjs test/daemon.mjs test/auth.mjs test/ofb-export.mjs",
+    "test": "npm run build && node test/emission-live.mjs && node --test test/wasm-live.mjs"
+  },
+  "dependencies": {
+    "@classcad/skill": "^0.0.6",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "sharp": "^0.34.5",
+    "ws": "^8.19.0",
+    "zod": "^4.4.3",
+    "@classcad/renderer": "^0.1.0",
+    "@classcad/script": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.13",
+    "typescript": "^5.6.0"
+  }
+}