Elementor Ultra

Elementor Ultra MCP

พื้นผิวควบคุมเอเจนต์สำหรับ Elementor เซิร์ฟเวอร์ Model Context Protocol + ปลั๊กอิน WordPress คู่หูที่ให้เอเจนต์ AI อ่าน สร้าง ปรับโครงสร้าง และจัดการไซต์ Elementor จริงได้แบบเดียวกับที่วิศวกรส่งซอฟต์แวร์ — เริ่มจากอิลิเมนต์อะตอมมิกของ Editor V4 ก่อน แล้วค่อย fallback ไป V3 คลาสสิก — พร้อมการตรวจสอบฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้, diffs, การสำรองข้อมูล และการย้อนกลับในทุกการเขียน

• packages/server — เซิร์ฟเวอร์ MCP แบบ TypeScript: 91 เครื่องมือ (elementor.page.*, widget, design, templates, media, nav, pro.*, แปลง HTML→Elementor), การขนส่งแบบ stdio + HTTP, โปรไฟล์เครื่องมือแบบ lean/full
• plugin/elementor-ultra-mcp — ปลั๊กอิน WordPress ที่เปิดเผย REST seam ที่เชื่อถือได้ (/wp-json/elementor-ultra/v1/*): ทุกการเขียนผ่านตัวตรวจสอบของ Elementor เอง Document::save() พร้อมสแนปช็อตสำรอง, การทำงานพร้อมกันแบบมองโลกในแง่ดี (base_hash), การเล่นซ้ำแบบ idempotency (op_id), ตัวตรวจสอบที่เชื่อถือได้ และการเตรียม CSS ที่จำเป็น
• packages/shared — พื้นผิวสัญญาที่ถูกตรึง: ทะเบียนเส้นทาง REST, อนุกรมวิธานข้อผิดพลาด, กระจก JSON-schema, ฟิกซ์เจอร์ทองคำ ไบต์เหมือนกับ spec/contracts/schemas (ป้องกันด้วย CI)
• spec/ — บันทึกวิศวกรรมทั้งหมด: สัญญา, ผลการทดสอบ spike และชุดงาน ที่ระบบถูกสร้างขึ้นมา

จับคู่กับ elementor-jsx — คอมไพเลอร์ JSX→Elementor ที่การ deploy ใช้ REST seam ของปลั๊กอินนี้

เริ่มต้นใช้งาน (ใช้กับเอเจนต์)

1. ติดตั้งปลั๊กอินคู่หูบนไซต์ WordPress ของคุณ (zip จาก Releases; ต้องใช้ 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 (ในคอนเทนเนอร์)	มีให้โดยคอนเทนเนอร์ Docker wp-env — ไม่ต้องใช้ 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 มัน พิมพ์ข้อความที่ชัดเจนและออกอย่างสะอาด (รหัสออก 0):

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

เมื่อถูกกำหนดค่า, มันอ่านตัวแปรสภาพแวดล้อมต่อไปนี้:

ตัวแปร	จำเป็น	ความหมาย
WP_URL	ใช่	URL ฐานของไซต์ WordPress เป้าหมาย
WP_USER	ใช่	ชื่อผู้ใช้ WordPress (เจ้าของ Application-Password)
WP_APP_PASSWORD	ใช่	Application Password ของ WordPress (การรับรอง HTTP Basic)
MCP_TRANSPORT	ไม่	stdio (ค่าเริ่มต้น) หรือ http (Streamable HTTP)
ULTRA_TOOLS	ไม่	lean (ค่าเริ่มต้น) หรือ full โปรไฟล์เครื่องมือ

การผูกการขนส่งจริง + ทะเบียนเครื่องมือถูกเพิ่มโดย WP-T01 ใน packages/server/src/server.ts ไบนารี (index.ts) ขี้เกียจ import()s ./server.js และพิมพ์ "server core not yet wired" จนกว่า โมดูลนั้นจะ存在 — ดังนั้นไบนารีคอมไพล์และบูตสแตนด์อโลนบนโครงนี้

---

ไซต์ WordPress สำหรับพัฒนาท้องถิ่น (wp-env)

ไซต์สำหรับพัฒนาใช้ @wordpress/env และปักหมุด Elementor 4.1.1 + Elementor Pro 4.1.0 อย่างแม่นยำ ผ่าน zip ปลั๊กอินท้องถิ่น (ไม่ใช่ slug ของ wp.org ซึ่งดึงเวอร์ชันล่าสุดและไม่โฮสต์ Pro เลย)

ที่อยู่ของ zip ปลั๊กอิน (และที่ต้องวาง Pro)

.wp-env.json อ้างอิง zip ท้องถิ่นสองไฟล์ภายใต้ .wp-env-plugins/ (ไดเรกทอรีที่ gitignored):

.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)

zip เหล่านี้ไม่ถูกคอมมิต (เป็นไบนารีที่ได้รับอนุญาตและถูก gitignored) หลังจากการ clone ใหม่ คุณต้องวางมันเอง:

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 เป็นปลั๊กอิน เนื้อหาของไดเรกทอรีนั้น (bootstrap, composer.json, phpcs.xml.dist, readme.txt, และ includes/) ถูกสร้างโดย WP-P01; เมื่อมันลงแล้ว ปลั๊กอินคู่หูสามารถเปิดใช้งานได้ในไซต์ wp-env การตั้งค่า Composer/PHPCS ของปลั๊กอินเอง ก็มีให้โดย WP-P01

---

โครงสร้าง Monorepo

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 เป็น peer ที่จำเป็น ห้ามเพิ่มแพ็กเกจ @modelcontextprotocol/* 2.x ใดๆ — ใน 1.x, inputSchema/outputSchema เป็น แผนที่ ZodRawShape และการขนส่งเป็น import .js แบบลึก CI ป้องกันการปรากฏของ dependency 2.x ในล็อกไฟล์ (WP-F07)