@yashwant.dharmdas/elementor-mcp 3.0.0 → 3.2.0

package/dist/index.js

@@ -939,6 +939,153 @@ function createMcpServer(sites) {
             return { content: [{ type: "text", text: `Error: ${e.response?.data?.message || e.message}` }], isError: true };
         }
     });
+    // ── Group 8: Page Creation & Publishing ──────────────────────────────────
+    server.tool("create-page", "Create a new WordPress page, optionally publish it immediately, and enable the Elementor editor. Returns the page ID and direct Elementor edit URL.", {
+        title: z.string().describe("Page title"),
+        status: z.enum(["draft", "publish", "private", "pending"]).optional().describe("Page status — default: draft"),
+        page_template: z.string().optional().describe("WordPress page template filename (e.g. 'elementor_canvas'). Leave blank for default."),
+        enable_elementor: z.boolean().optional().describe("Initialize the Elementor editor on this page (default: true)"),
+        site: siteParam,
+    }, async ({ title, status, page_template, enable_elementor, site }) => {
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const body = {
+                title,
+                status: status ?? "draft",
+                enable_elementor: enable_elementor ?? true,
+            };
+            if (page_template)
+                body.page_template = page_template;
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/pages`, body, {
+                headers: { Authorization: authHeader, "Content-Type": "application/json" },
+            });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error creating page: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
+    server.tool("publish-page", "Change the publish status of a WordPress page (publish, draft, private, pending, trash).", {
+        page_id: z.string().describe("WordPress Page ID"),
+        status: z.enum(["publish", "draft", "private", "pending", "trash"]).describe("Target status"),
+        site: siteParam,
+    }, async ({ page_id, status, site }) => {
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const r = await axios.patch(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/status`, { status }, { headers: { Authorization: authHeader, "Content-Type": "application/json" } });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error updating page status: ${error.response?.data?.message || error.message}` }], isError: true };
+        }
+    });
+    server.tool("enable-elementor", "Enable the Elementor editor on an existing WordPress page that was not originally built with Elementor. Returns the direct Elementor edit URL.", {
+        page_id: z.string().describe("WordPress Page ID"),
+        site: siteParam,
+    }, async ({ page_id, site }) => {
+        try {
+            const { wpUrl, authHeader } = resolveSite(sites, site);
+            const r = await axios.post(`${wpUrl}/wp-json/erc/v1/pages/${page_id}/enable-elementor`, {}, { headers: { Authorization: authHeader } });
+            return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+        }
+        catch (error) {
+            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.0.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": {