Elementor Ultra

Elementor Ultra MCP

Agent के लिए Elementor नियंत्रण सतह। एक Model Context Protocol सर्वर + साथी WordPress प्लगइन जो AI एजेंटों को वास्तविक Elementor साइटों को पढ़ने, बनाने, रिफैक्टर करने और नियंत्रित करने की अनुमति देता है, उसी तरह जैसे इंजीनियर सॉफ़्टवेयर शिप करते हैं — पहले Editor V4 परमाणु तत्व, V3 क्लासिक फ़ॉलबैक — हर लेखन पर आधिकारिक सर्वर-साइड सत्यापन, डिफ़, बैकअप और रोलबैक के साथ।

• packages/server — TypeScript MCP सर्वर: 91 टूल (elementor.page.*, widget, design, templates, media, nav, pro.*, HTML→Elementor कनवर्ट), stdio + HTTP ट्रांसपोर्ट, लीन/फुल टूल प्रोफ़ाइल।
• plugin/elementor-ultra-mcp — WordPress प्लगइन जो आधिकारिक REST सीम (/wp-json/elementor-ultra/v1/*) को उजागर करता है: हर लेखन Elementor के अपने Document::save() से होकर जाता है, बैकअप स्नैपशॉट, आशावादी समवर्ती (base_hash), आइडेम्पोटेंसी (op_id) रीप्ले, आधिकारिक वैलिडेटर, और अनिवार्य CSS प्राइमिंग के साथ।
• packages/shared — जमे हुए अनुबंध सतह: REST रूट रजिस्ट्री, त्रुटि वर्गीकरण, JSON-schema मिरर, गोल्डन फिक्स्चर। spec/contracts/schemas के लिए बाइट-समान (CI-संरक्षित)।
• spec/ — पूर्ण इंजीनियरिंग रिकॉर्ड: अनुबंध, स्पाइक निर्णय और कार्य पैकेज जिनके विरुद्ध सिस्टम बनाया गया था।

elementor-jsx के साथ जोड़ा गया — JSX→Elementor कंपाइलर जिसकी डिप्लॉय इस प्लगइन की REST सीम से होकर जाती है।

त्वरित आरंभ (एजेंट के साथ उपयोग करें)

1. अपनी WordPress साइट पर साथी प्लगइन स्थापित करें (Releases से zip; Elementor ≥ 4.1 आवश्यक है) और एक एप्लिकेशन पासवर्ड बनाएं।
2. सर्वर को अपने MCP क्लाइंट में तारें (.mcp.json):

{
  "mcpServers": {
    "elementor-ultra": {
      "command": "node",
      "args": ["/path/to/elementor-ultra-mcp/packages/server/dist/index.js"],
      "env": {
        "WP_URL": "https://your-site.com",
        "WP_USER": "admin",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "ULTRA_TOOLS": "full",
      },
    },
  },
}

3. अपने एजेंट से पेज सूचीबद्ध करने, ट्री का ड्राई-रन करने, पेज बनाने के लिए कहें। हर उत्परिवर्तन को सहेजने से पहले Elementor के अपने पार्सर द्वारा सर्वर-साइड पर सत्यापित किया जाता है; अमान्य ट्री वर्गीकरण त्रुटि कोड के साथ परमाणु रूप से अस्वीकृत होते हैं।

लाइसेंसिंग

• TypeScript पैकेज (packages/*): MIT © 2026 Algorismus
• WordPress प्लगइन (plugin/elementor-ultra-mcp): GPL-2.0-or-later (WordPress परंपरा)

Elementor Ltd से संबद्ध या समर्थित नहीं — "Elementor" उनका ट्रेडमार्क है; यह एक स्वतंत्र एकीकरण है जो उनके पेज प्रारूप को लक्षित करता है।

---

पूर्वापेक्षाएँ

उपकरण	संस्करण	नोट्स
Node.js	≥ 20 LTS	.nvmrc 20 को पिन करता है। engine-strict=true लागू किया गया है।
pnpm	9.x	पैकेज मैनेजर; लॉकफ़ाइल प्रतिबद्ध है।
Docker	चालू	@wordpress/env (wp-env) के लिए डेव WP साइट के लिए आवश्यक।
PHP	≥ 7.4 (कंटेनर में)	wp-env Docker कंटेनर द्वारा प्रदान किया गया — कोई होस्ट PHP की आवश्यकता नहीं।
Composer	(कंटेनर में)	प्लगइन का Composer/PHPCS सेटअप WP-P01 द्वारा प्रदान किया गया।

होस्ट पर PHP या Composer की आवश्यकता नहीं है; PHP टूलिंग wp-env कंटेनर के अंदर चलती है।

---

स्थापना और निर्माण

pnpm install        # installs all workspace deps; writes/uses pnpm-lock.yaml
pnpm build          # turbo: compiles packages/shared + packages/server (strict TS)
pnpm lint           # eslint (typescript-eslint, recommended-type-checked) across the workspace
pnpm format:check   # prettier --check
pnpm test:unit      # turbo: vitest run in each package

सर्वर बिन चलाना (अभी कोई टूल वायर्ड नहीं)

pnpm build के बाद, सर्वर बिन packages/server/dist/index.js पर मौजूद है। कोई env सेट नहीं होने पर यह एक स्पष्ट संदेश प्रिंट करता है और सफाई से बाहर निकलता है (exit code 0):

node packages/server/dist/index.js
# -> elementor-ultra-mcp: missing required environment variable(s): WP_URL, WP_USER, WP_APP_PASSWORD. ...

कॉन्फ़िगर होने पर, यह निम्नलिखित पर्यावरण चर पढ़ता है:

चर	आवश्यक	अर्थ
WP_URL	हाँ	लक्षित WordPress साइट का आधार URL।
WP_USER	हाँ	WordPress उपयोगकर्ता नाम (एप्लिकेशन-पासवर्ड स्वामी)।
WP_APP_PASSWORD	हाँ	WordPress एप्लिकेशन पासवर्ड (HTTP बेसिक प्रमाणीकरण)।
MCP_TRANSPORT	नहीं	stdio (डिफ़ॉल्ट) या http (स्ट्रीमेबल HTTP)।
ULTRA_TOOLS	नहीं	lean (डिफ़ॉल्ट) या full टूल प्रोफ़ाइल।

वास्तविक ट्रांसपोर्ट बाइंडिंग + टूल रजिस्ट्री WP-T01 द्वारा packages/server/src/server.ts में जोड़ी जाती है। बिन (index.ts) आलसी रूप से ./server.js को import() करता है और तब तक "server core not yet wired" प्रिंट करता है जब तक वह मॉड्यूल मौजूद नहीं होता — इसलिए बिन इस स्कैफोल्ड पर स्वतंत्र रूप से कंपाइल और बूट होता है।

---

स्थानीय WordPress डेव साइट (wp-env)

डेव साइट @wordpress/env का उपयोग करती है और स्थानीय प्लगइन ज़िप के माध्यम से Elementor 4.1.1 + Elementor Pro 4.1.0 को ठीक पिन करती है (wp.org स्लग नहीं, जो नवीनतम संस्करण खींचता है और Pro को बिल्कुल होस्ट नहीं करता)।

प्लगइन ज़िप कहाँ रहते हैं (और Pro को कहाँ रखा जाना चाहिए)

.wp-env.json .wp-env-plugins/ के अंतर्गत दो स्थानीय ज़िप संदर्भित करता है (एक गिटिग्नोर किया गया निर्देशिका):

.wp-env-plugins/
├─ elementor.4.1.1.zip        # Elementor free 4.1.1
└─ elementor-pro.4.1.0.zip    # Elementor Pro 4.1.0  (licensed; not on wp.org)

ये ज़िप प्रतिबद्ध नहीं हैं (वे लाइसेंस प्राप्त बाइनरी हैं और गिटिग्नोर हैं)। एक नए क्लोन के बाद आपको उन्हें स्वयं रखना होगा:

mkdir -p .wp-env-plugins
cp /path/to/elementor.4.1.1.zip      .wp-env-plugins/elementor.4.1.1.zip
cp /path/to/elementor-pro.4.1.0.zip  .wp-env-plugins/elementor-pro.4.1.0.zip

उपरोक्त सटीक फ़ाइलनाम .wp-env.json में पथों से मेल खाने चाहिए।

प्रारंभ / रोक

pnpm wp-env:start   # boots WordPress + Elementor 4.1.1 + Pro 4.1.0; mounts the companion plugin
pnpm wp-env:stop

.wp-env.json भी ./plugin/elementor-ultra-mcp को एक प्लगइन के रूप में माउंट करता है। उस निर्देशिका की सामग्री (बूटस्ट्रैप, composer.json, phpcs.xml.dist, readme.txt, और includes/) WP-P01 द्वारा बनाई जाती हैं; एक बार वे आने के बाद साथी प्लगइन wp-env साइट में सक्रिय हो जाता है। प्लगइन का अपना Composer/PHPCS कॉन्फ़िगरेशन भी WP-P01 द्वारा प्रदान किया जाता है।

---

मोनोरेपो लेआउट

elementor-ultra-mcp/
├─ packages/
│  ├─ server/      # TS MCP server (bin: elementor-ultra-mcp)
│  └─ shared/      # shared types + JSON Schemas + fixtures
├─ plugin/
│  └─ elementor-ultra-mcp/   # companion WP plugin (PHP) — populated by WP-P01
├─ spec/           # frozen architecture + contracts + work packages
├─ .wp-env.json    # pins Elementor 4.1.1 + Pro 4.1.0 (local zips) + mounts the plugin
└─ (root tooling: pnpm-workspace.yaml, turbo.json, tsconfig.base.json, eslint, prettier)

MCP SDK पिन (LOCKED)

packages/server @modelcontextprotocol/sdk ^1.29 को आवश्यक पीयर के रूप में zod के साथ पिन करता है। कभी भी कोई @modelcontextprotocol/* 2.x पैकेज न जोड़ें — 1.x में, inputSchema/outputSchema हैं ZodRawShape मैप और ट्रांसपोर्ट गहरे .js आयात हैं। CI लॉकफ़ाइल में 2.x निर्भरता दिखने से रोकता है (WP-F07)।