@yashwant.dharmdas/elementor-mcp 3.1.0 → 3.2.0

package/dist/index.js

@@ -992,6 +992,100 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error enabling Elementor: ${error.response?.data?.message || error.message}` }], isError: true };
         }
     });
+    // ── Group 9: Screenshot ──────────────────────────────────────────────────────
+    server.tool("screenshot-page", "Take a full-page screenshot of a published WordPress page using the system-installed Google Chrome browser. Returns the screenshot as an image so you can visually review design, layout, and content. Requires the page to be publicly accessible (status: publish).", {
+        page_id: z.string().describe("WordPress Page ID"),
+        full_page: z.boolean().optional().describe("Capture the full scrollable page height (default: true)"),
+        width: z.number().optional().describe("Viewport width in pixels (default: 1440)"),
+        site: siteParam,
+    }, async ({ page_id, full_page, width, site }) => {
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            // ── 1. Resolve the page's public URL from WP REST API ──────────────
+            const pageRes = await axios.get(`${wpUrl}/wp-json/wp/v2/pages/${page_id}`, {
+                headers: { Authorization: authHeader },
+            });
+            const pageUrl = pageRes.data.link;
+            if (!pageUrl)
+                throw new Error("Could not resolve public URL for this page.");
+            // ── 2. Detect system Chrome ──────────────────────────────────────
+            const chromePaths = [
+                // Windows
+                "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+                "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
+                // macOS
+                "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+                // Linux
+                "/usr/bin/google-chrome",
+                "/usr/bin/google-chrome-stable",
+                "/usr/bin/chromium-browser",
+                "/usr/bin/chromium",
+            ];
+            let executablePath;
+            for (const p of chromePaths) {
+                if (fs.existsSync(p)) {
+                    executablePath = p;
+                    break;
+                }
+            }
+            if (!executablePath) {
+                throw new Error("Google Chrome not found on this machine.\n" +
+                    "Install Chrome from https://www.google.com/chrome/ and ensure it is in a standard location.\n" +
+                    "Checked paths:\n" + chromePaths.map(p => `  • ${p}`).join("\n"));
+            }
+            // ── 3. Launch puppeteer-core with system Chrome ─────────────────
+            let puppeteer;
+            try {
+                puppeteer = await import("puppeteer-core");
+            }
+            catch {
+                throw new Error("puppeteer-core is not installed. Run: npm install puppeteer-core\n" +
+                    "(or reinstall @yashwant.dharmdas/elementor-mcp — it is bundled as a dependency)");
+            }
+            const browser = await puppeteer.launch({
+                executablePath,
+                headless: true,
+                args: [
+                    "--no-sandbox",
+                    "--disable-setuid-sandbox",
+                    "--disable-dev-shm-usage",
+                    "--disable-gpu",
+                ],
+            });
+            try {
+                const page = await browser.newPage();
+                await page.setViewport({ width: width ?? 1440, height: 900, deviceScaleFactor: 1 });
+                await page.goto(pageUrl, { waitUntil: "networkidle2", timeout: 30_000 });
+                // Small pause to let JS-heavy pages finish rendering
+                await new Promise(resolve => setTimeout(resolve, 1000));
+                const screenshotBuffer = await page.screenshot({
+                    fullPage: full_page ?? true,
+                    type: "png",
+                });
+                const base64 = Buffer.isBuffer(screenshotBuffer)
+                    ? screenshotBuffer.toString("base64")
+                    : Buffer.from(screenshotBuffer).toString("base64");
+                return {
+                    content: [
+                        {
+                            type: "image",
+                            data: base64,
+                            mimeType: "image/png",
+                        },
+                    ],
+                };
+            }
+            finally {
+                await browser.close();
+            }
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error taking screenshot: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
     return server;
 }
 // ─── Entry Point ──────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yashwant.dharmdas/elementor-mcp",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "MCP server for controlling Elementor via Claude — supports multiple WordPress sites",
   "main": "dist/index.js",
   "type": "module",
@@ -19,6 +19,7 @@
     "@modelcontextprotocol/sdk": "^1.26.0",
     "ajv": "^8.12.0",
     "axios": "^1.6.0",
+    "puppeteer-core": "^22.15.0",
     "zod": "^3.22.4"
   },
   "devDependencies": {