Elementor Ultra

Elementor Ultra MCP

Elementor için aracı kontrol yüzeyi. AI aracılarının gerçek Elementor sitelerini mühendislerin yazılım yayınlama şekliyle okumasını, oluşturmasını, yeniden düzenlemesini ve yönetmesini sağlayan bir Model Context Protocol sunucusu + yardımcı WordPress eklentisi — Önce Editor V4 atomik öğeleri, V3 klasik yedek — her yazmada yetkili sunucu tarafı doğrulama, diff'ler, yedekler ve geri alma ile.

• packages/server — TypeScript MCP sunucusu: 91 araç (elementor.page.*, widget, design, templates, media, nav, pro.*, HTML→Elementor dönüştürücü), stdio + HTTP taşımaları, sade/tam araç profilleri.
• plugin/elementor-ultra-mcp — Yetkili REST bağlantı noktasını (/wp-json/elementor-ultra/v1/*) ortaya çıkaran WordPress eklentisi: her yazma, Elementor'un kendi Document::save() ile yedek anlık görüntüleri, iyimser eşzamanlılık (base_hash), idempotency (op_id) tekrarı, yetkili doğrulayıcı ve zorunlu CSS hazırlama işlemlerinden geçer.
• packages/shared — dondurulmuş sözleşme yüzeyi: REST rota kayıt defteri, hata taksonomisi, JSON-şema yansımaları, altın fikstürler. spec/contracts/schemas ile bayt-aynı (CI korumalı).
• spec/ — tam mühendislik kaydı: sistemin üzerine inşa edildiği sözleşmeler, spike kararları ve iş paketleri.

elementor-jsx ile eşleşir — bu eklentinin REST bağlantı noktası üzerinde dağıtımları geçen JSX→Elementor derleyicisi.

Hızlı başlangıç (bir aracıyla kullanın)

1. WordPress sitenize yardımcı eklentiyi kurun (Releases'ten zip; Elementor ≥ 4.1 gerektirir) ve bir uygulama şifresi oluşturun.
2. Sunucuyu MCP istemcinize bağlayın (.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. Aracınızdan sayfaları listelemesini, bir ağacı kuru çalıştırmasını, bir sayfa oluşturmasını isteyin. Her mutasyon, herhangi bir kayıt öncesinde sunucu tarafında Elementor'un kendi ayrıştırıcıları tarafından doğrulanır; geçersiz ağaçlar, taksonomik hata koduyla atomik olarak reddedilir.

Lisans

• TypeScript paketleri (packages/*): MIT © 2026 Algorismus
• WordPress eklentisi (plugin/elementor-ultra-mcp): GPL-2.0-or-later (WordPress kuralı)

Elementor Ltd ile bağlantılı veya onaylı değildir — "Elementor" onların ticari markasıdır; bu, onların sayfa biçimini hedefleyen bağımsız bir entegrasyondur.

---

Ön koşullar

Araç	Sürüm	Notlar
Node.js	≥ 20 LTS	.nvmrc 20 sürümünü sabitler. engine-strict=true zorunludur.
pnpm	9.x	Paket yöneticisi; lockfile depolanır.
Docker	çalışıyor	Geliştirme WP sitesi için @wordpress/env (wp-env) tarafından gereklidir.
PHP	≥ 7.4 (kapsayıcıda)	wp-env Docker kapsayıcısı tarafından sağlanır — ana bilgisayarda PHP gerekmez.
Composer	(kapsayıcıda)	Eklentinin Composer/PHPCS kurulumu WP-P01 tarafından sağlanır.

Ana bilgisayarda PHP veya Composer'a ihtiyacınız yok; PHP araçları wp-env kapsayıcısının içinde çalışır.

---

Kurulum ve derleme

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

Sunucu ikilisini çalıştırma (henüz araçlar bağlı değilken)

pnpm build sonrasında sunucu ikilisi packages/server/dist/index.js konumunda bulunur. Hiçbir ortam değişkeni ayarlanmadan net bir mesaj yazdırır ve temiz şekilde çıkar (çıkış kodu 0):

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

Yapılandırıldığında şu ortam değişkenlerini okur:

Değişken	Zorunlu	Anlamı
WP_URL	evet	Hedef WordPress sitesinin temel URL'si.
WP_USER	evet	WordPress kullanıcı adı (Uygulama Şifresi sahibi).
WP_APP_PASSWORD	evet	WordPress Uygulama Şifresi (HTTP Temel kimlik doğrulama).
MCP_TRANSPORT	hayır	stdio (varsayılan) veya http (Akışlı HTTP).
ULTRA_TOOLS	hayır	lean (varsayılan) veya full araç profili.

Gerçek taşıma bağlantısı + araç kayıt defteri, packages/server/src/server.ts içindeki WP-T01 tarafından eklenir. İkili (index.ts), ./server.js öğesini tembel olarak import() yapar ve bu modül var olana kadar "sunucu çekirdeği henüz bağlanmadı" yazdırır — böylece bu iskelet üzerinde ikili derlenir ve bağımsız olarak başlar.

---

Yerel WordPress geliştirme sitesi (wp-env)

Geliştirme sitesi @wordpress/env kullanır ve Elementor 4.1.1 + Elementor Pro 4.1.0 sürümlerini tam olarak yerel eklenti zip'leri aracılığıyla sabitler (wp.org slug'ı değil; bu en son sürümü çeker ve Pro'yu hiç barındırmaz).

Eklenti zip'lerinin bulunduğu yer (ve Pro'nun nereye yerleştirilmesi gerektiği)

.wp-env.json, .wp-env-plugins/ altında (bir gitignore'lu dizin) iki yerel zip'e başvurur:

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

Bu zip'ler teslim edilmez (lisanslı ikili dosyalardır ve gitignore'ludur). Yeni bir klon sonrasında bunları kendiniz yerleştirmelisiniz:

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

Yukarıdaki tam dosya adları, .wp-env.json içindeki yollarla eşleşmelidir.

Başlat / durdur

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 ayrıca ./plugin/elementor-ultra-mcp öğesini bir eklenti olarak bağlar. Bu dizinin içeriği (bootstrap, composer.json, phpcs.xml.dist, readme.txt ve includes/) WP-P01 tarafından oluşturulur; bunlar yerleştirildiğinde yardımcı eklenti wp-env sitesinde etkinleştirilebilir. Eklentinin kendi Composer/PHPCS yapılandırması da WP-P01 tarafından sağlanır.

---

Monorepo düzeni

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 sabitlemesi (KİLİTLİ)

packages/server, gerekli bir eş olarak zod ile @modelcontextprotocol/sdk ^1.29 sürümünü sabitler. Asla herhangi bir @modelcontextprotocol/* 2.x paketi eklemeyin — 1.x'te, inputSchema/outputSchema ZodRawShape haritalarıdır ve taşımalar derin .js içe aktarmalarıdır. CI, lockfile'da bir 2.x bağımlılığının görünmesini engeller (WP-F07).