@yashwant.dharmdas/elementor-mcp 3.2.3 → 3.2.5

package/dist/index.js

@@ -1127,13 +1127,58 @@ function createMcpServer(sites) {
                 // Extra settle time for fonts, animations, videos
                 await new Promise(resolve => setTimeout(resolve, wait ?? 2000));
                 const fmt = format ?? "jpeg";
-                const screenshotOptions = { type: fmt, fullPage: !max_height && (full_page ?? true) };
-                if (fmt === "jpeg")
-                    screenshotOptions.quality = quality ?? 82;
+                const baseOptions = { type: fmt, fullPage: !max_height && (full_page ?? true) };
                 if (max_height)
-                    screenshotOptions.clip = { x: 0, y: 0, width: vpWidth, height: vpHeight };
-                const screenshotBuffer = await page.screenshot(screenshotOptions);
-                const buf = Buffer.isBuffer(screenshotBuffer) ? screenshotBuffer : Buffer.from(screenshotBuffer);
+                    baseOptions.clip = { x: 0, y: 0, width: vpWidth, height: vpHeight };
+                // ── Adaptive capture: always fit under the MCP 1MB tool-result limit ──
+                // (base64 overhead ~33%, so raw buffer must be ≤ ~780KB)
+                const PREVIEW_LIMIT = 750 * 1024;
+                let buf = Buffer.alloc(0);
+                let usedQuality = undefined;
+                let usedScale = 1;
+                const takeOne = async (q, scale) => {
+                    if (scale !== 1) {
+                        // Re-apply viewport with scale factor to shrink pixel dimensions
+                        await page.setViewport({ width: Math.round(vpWidth * scale), height: Math.round(vpHeight * scale), deviceScaleFactor: 1 });
+                        // Allow layout to reflow
+                        await new Promise(r => setTimeout(r, 500));
+                    }
+                    const opts = { ...baseOptions };
+                    if (q !== undefined)
+                        opts.quality = q;
+                    const raw = await page.screenshot(opts);
+                    return Buffer.isBuffer(raw) ? raw : Buffer.from(raw);
+                };
+                if (fmt === "jpeg") {
+                    // Stage 1: try full resolution, progressive quality
+                    const q0 = quality ?? 82;
+                    const qualitySteps = Array.from(new Set([q0, 70, 55, 40, 25, 15])).filter(q => q <= q0);
+                    for (const q of qualitySteps) {
+                        buf = await takeOne(q, 1);
+                        usedQuality = q;
+                        if (buf.length <= PREVIEW_LIMIT)
+                            break;
+                    }
+                    // Stage 2: if still too big, shrink viewport width progressively
+                    const scaleSteps = [0.7, 0.5, 0.35, 0.25];
+                    for (const s of scaleSteps) {
+                        if (buf.length <= PREVIEW_LIMIT)
+                            break;
+                        buf = await takeOne(40, s);
+                        usedQuality = 40;
+                        usedScale = s;
+                        if (buf.length <= PREVIEW_LIMIT)
+                            break;
+                        // Inner quality drop at this scale
+                        buf = await takeOne(20, s);
+                        usedQuality = 20;
+                        if (buf.length <= PREVIEW_LIMIT)
+                            break;
+                    }
+                }
+                else {
+                    buf = await takeOne(undefined, 1);
+                }
                 // ── 5. Save to disk ─────────────────────────────────────────────
                 const ext = fmt === "jpeg" ? "jpg" : "png";
                 const idPart = page_id ?? (pageUrl.replace(/https?:\/\//, "").replace(/[^a-z0-9]/gi, "_").slice(0, 40));
@@ -1142,29 +1187,32 @@ function createMcpServer(sites) {
                 fs.writeFileSync(filePath, buf);
                 const sizeKB = Math.round(buf.length / 1024);
                 const mimeType = `image/${fmt}`;
-                // ── 6. Return image preview if small enough, always return path ─
-                const PREVIEW_LIMIT = 750 * 1024; // 750 KB raw → ~1 MB base64
-                const content = [
-                    {
-                        type: "text",
-                        text: [
-                            `✅ Screenshot saved successfully.`,
-                            `📁 file_path: ${filePath}`,
-                            `📐 Size: ${sizeKB} KB  |  Format: ${ext.toUpperCase()}  |  URL: ${pageUrl}`,
-                            ``,
-                            `👉 To upload to Basecamp, call upload_attachment with:`,
-                            `   file_path = "${filePath}"`,
-                            `   project_id = <your Basecamp project ID>`,
-                        ].join("\n"),
-                    },
-                ];
+                const qualityNote = usedQuality !== undefined && usedQuality !== (quality ?? 82)
+                    ? `  |  Auto-downscaled to quality ${usedQuality}${usedScale !== 1 ? ` @ ${Math.round(usedScale * 100)}% width` : ""} to fit MCP limit`
+                    : "";
+                // ── 6. Always return the image so Claude can analyse it ──────
+                const content = [];
                 if (buf.length <= PREVIEW_LIMIT) {
-                    content.unshift({
+                    content.push({
                         type: "image",
                         data: buf.toString("base64"),
                         mimeType,
                     });
                 }
+                content.push({
+                    type: "text",
+                    text: [
+                        `✅ Screenshot captured and saved.`,
+                        `📁 file_path: ${filePath}`,
+                        `📐 Size: ${sizeKB} KB  |  Format: ${ext.toUpperCase()}${qualityNote}`,
+                        `🌐 URL: ${pageUrl}`,
+                        buf.length > PREVIEW_LIMIT
+                            ? `\n⚠️  Image still exceeds the 1MB MCP return limit even at lowest quality. The file is saved to disk and can be used via upload_attachment(file_path).`
+                            : ``,
+                        ``,
+                        `👉 To upload to Basecamp: upload_attachment with file_path = "${filePath}"`,
+                    ].filter(Boolean).join("\n"),
+                });
                 return { content };
             }
             finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yashwant.dharmdas/elementor-mcp",
-  "version": "3.2.3",
+  "version": "3.2.5",
   "description": "MCP server for controlling Elementor via Claude — supports multiple WordPress sites",
   "main": "dist/index.js",
   "type": "module",