@appaflytech/wappa-mcp 0.0.1

package/.env.example

@@ -0,0 +1,5 @@
+WAP_ADMIN_API_URL=http://localhost:5002
+WAP_SITE_ID=
+WAP_EMAIL=email
+WAP_PASSWORD=password
+WAP_LANGUAGE=tr

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AppaFlyTech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,200 @@
+# wappa-mcp
+
+WAPPA (Content Management System & Web Site Tools) Admin API için [MCP (Model Context Protocol)](https://modelcontextprotocol.io) Server.
+
+Claude Code'a WAPPA Admin API üzerinde doğrudan CRUD işlemleri yapma yeteneği kazandırır: site, sayfa, bileşen, layout, entity, query, menü, tema, dil ve daha fazlasını yönetin.
+
+## Kurulum
+
+### npx ile (Kurulum Gerektirmez)
+
+Doğrudan MCP yapılandırmasında kullanabilirsiniz — ayrıca `npm install` yapmanıza gerek yok:
+
+```json
+{
+  "mcpServers": {
+    "wap": {
+      "command": "npx",
+      "args": ["-y", "wappa-mcp"],
+      "env": {
+        "WAP_ADMIN_API_URL": "https://your-wap-admin-api-url.com",
+        "WAP_SITE_KEY": "your-site-slug",
+        "WAP_EMAIL": "admin@example.com",
+        "WAP_PASSWORD": "your-password",
+        "WAP_LANGUAGE": "en-us"
+      }
+    }
+  }
+}
+```
+
+### Global Kurulum
+
+```bash
+npm install -g wappa-mcp
+```
+
+### Proje İçi Kurulum
+
+```bash
+npm install wappa-mcp
+```
+
+## Yapılandırma
+
+### Environment Variables
+
+| Değişken            | Zorunlu | Açıklama                                    | Örnek                                  |
+| ------------------- | ------- | ------------------------------------------- | -------------------------------------- |
+| `WAP_ADMIN_API_URL` | Evet    | Admin API base URL                          | `https://wap-admin-api.example.com`    |
+| `WAP_SITE_KEY`      | Evet    | Site slug/key (URL'de kullanılan kısa isim) | `glomil`                               |
+| `WAP_SITE_ID`       | Hayır   | `WAP_SITE_KEY` yoksa fallback site ID       | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
+| `WAP_EMAIL`         | Evet    | Admin kullanıcı e-postası                   | `admin@example.com`                    |
+| `WAP_PASSWORD`      | Evet    | Admin kullanıcı şifresi                     | `your-password`                        |
+| `WAP_LANGUAGE`      | Hayır   | API dili (Accept-Language header)           | `tr` (varsayılan)                      |
+
+### Claude Code MCP Yapılandırması
+
+Projenizin `.claude/mcp.json` dosyasına ekleyin:
+
+```json
+{
+  "mcpServers": {
+    "wap": {
+      "command": "npx",
+      "args": ["-y", "wappa-mcp"],
+      "env": {
+        "WAP_ADMIN_API_URL": "https://wap-admin-api.example.com",
+        "WAP_SITE_KEY": "your-site-slug",
+        "WAP_EMAIL": "admin@example.com",
+        "WAP_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+## Kullanılabilir Tool'lar
+
+### Sites (Siteler)
+
+- `list_sites` — Tüm siteleri listele
+- `get_site` — Site detayı getir
+- `create_site` — Yeni site oluştur
+- `update_site` — Site güncelle
+- `delete_site` — Site sil
+- `get_sites_with_entities` — Site + entity şemaları birlikte getir
+
+### Pages (Sayfalar)
+
+- `list_pages` — Sayfaları listele (başlık/path/layout/status filtresi)
+- `get_page` — Sayfa detayı getir (views, layout, meta dahil)
+- `create_page` — Yeni sayfa oluştur (views, refs, layoutId ile)
+- `update_page` — Sayfa güncelle
+- `delete_page` — Sayfa sil
+- `publish_page` — Sayfayı yayınla (Draft → Published)
+- `unpublish_page` — Sayfayı yayından kaldır (Published → Draft)
+- `get_page_versions` — Sayfa versiyonlarını listele
+- `generate_page_path` — Benzersiz URL path öner
+- `create_page_localization` — Sayfa çevirisi oluştur
+
+### Components (Bileşenler)
+
+- `list_components` — API'deki özel bileşenleri listele
+- `get_component` — Bileşen detayı getir; GUID verilirse API'ye gider, kebab-case isim (örn: `heading`) verilirse önce yerleşik base bileşenlerde arar
+- `create_component` — Yeni bileşen oluştur (schema dahil)
+- `update_component` — Bileşeni güncelle
+- `delete_component` — Bileşeni sil
+- `list_base_components` — Sistemde yerleşik gelen base (built-in) bileşenleri listele; `isMobile` ve `type` parametreleriyle filtrele. Schema değişikliği için `src/base-components.ts` düzenle.
+
+### Layouts
+
+- `list_layouts` — Layout'ları listele
+- `get_layout` — Layout detayı getir
+- `create_layout` — Yeni layout oluştur
+- `update_layout` — Layout güncelle
+- `delete_layout` — Layout sil
+- `clone_layout` — Layout kopyala
+- `clone_layout_to_site` — Layout'u başka siteye kopyala
+
+### Entities (Varlık Şemaları)
+
+- `list_entities` — Entity şemalarını listele
+- `get_entity` — Entity detayı getir
+- `create_entity` — Yeni entity şeması oluştur
+- `update_entity` — Entity şemasını güncelle
+- `delete_entity` — Entity sil
+- `get_entity_relations` — Entity ilişkilerini getir
+
+### Dynamic Entities (Kayıtlar / İçerikler)
+
+- `list_dynamic_entity_records` — Entity kayıtlarını listele
+- `get_dynamic_entity_record` — Kayıt detayı getir
+- `create_dynamic_entity_record` — Yeni kayıt oluştur
+- `update_dynamic_entity_record` — Kaydı güncelle
+- `update_dynamic_entity_status` — Kayıt durumunu değiştir
+- `delete_dynamic_entity_record` — Kaydı sil
+- `clone_dynamic_entity_record` — Kaydı kopyala
+- `create_dynamic_entity_localization` — Kayıt çevirisi oluştur
+- `get_dynamic_entity_versions` — Kayıt versiyonlarını listele
+
+### Queries
+
+- `list_queries` — Query'leri listele
+- `get_query` — Query detayı getir
+- `run_query` — Query çalıştır
+- `create_query` — Yeni query oluştur (sql/rest/js)
+- `update_query` — Query güncelle
+- `delete_query` — Query sil
+
+### Menus (Menüler)
+
+- `list_menus` — Menüleri listele
+- `get_menu` — Menü detayı getir
+- `create_menu` — Yeni menü oluştur
+- `update_menu` — Menü güncelle
+- `delete_menu` — Menü sil
+- `clone_menu` — Menü kopyala
+
+### Widgets
+
+- `list_widgets` — Widget tanımlarını listele
+- `get_widget` — Widget detayı getir
+- `create_widget` — Yeni widget oluştur
+- `update_widget` — Widget güncelle
+- `delete_widget` — Widget sil
+
+### Themes (Temalar)
+
+- `list_themes` — Tema ayarlarını listele
+- `get_theme` — Tema detayı getir
+- `create_theme` — Yeni tema oluştur (renkler, yazı boyutları)
+- `update_theme` — Tema güncelle
+- `delete_theme` — Tema sil
+
+### Languages (Diller)
+
+- `list_languages` — Desteklenen dilleri listele
+- `get_language` — Dil detayı getir
+- `create_language` — Yeni dil ekle
+- `update_language` — Dil güncelle
+- `delete_language` — Dil sil
+
+### General
+
+- `get_app_settings` — Uygulama ayarlarını getir
+- `update_app_settings` — Uygulama ayarlarını güncelle
+- `wap_custom_request` — Herhangi bir Admin API endpoint'ine özel istek gönder
+
+## Kimlik Doğrulama
+
+Server, **email + şifre** ile doğrudan Admin API'ye giriş yapar:
+
+1. `WAP_ADMIN_API_URL/auth/sign-in` endpoint'ine POST `{ email, password }`
+2. Dönen JWT token'ı cache'ler
+3. Token'ın `exp` claim'inden süre hesaplanır, 5 dakika öncesinde yenilenir
+4. Her API isteğinde `Authorization: Bearer <token>` header'ı eklenir
+
+## Lisans
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WAP Admin API Token Management
+ * Uses email/password sign-in (POST /Auth/sign-in) — no separate Identity Server.
+ * The returned JWT is cached until 5 minutes before its expiry.
+ */
+interface AuthConfig {
+    adminApiUrl: string;
+    email: string;
+    password: string;
+}
+export declare class TokenManager {
+    private token;
+    private tokenExpiry;
+    private config;
+    constructor(config: AuthConfig);
+    getToken(): Promise<string>;
+    invalidate(): void;
+}
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAeD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,UAAU;IAIxB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAuCjC,UAAU,IAAI,IAAI;CAInB"}

package/dist/auth.js

@@ -0,0 +1,58 @@
+/**
+ * WAP Admin API Token Management
+ * Uses email/password sign-in (POST /Auth/sign-in) — no separate Identity Server.
+ * The returned JWT is cached until 5 minutes before its expiry.
+ */
+/** Parse the `exp` claim from a JWT (seconds since epoch). Returns 0 on parse failure. */
+function parseJwtExpiry(jwt) {
+    try {
+        const payload = jwt.split(".")[1];
+        const decoded = JSON.parse(Buffer.from(payload, "base64url").toString("utf-8"));
+        return typeof decoded.exp === "number" ? decoded.exp * 1000 : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+export class TokenManager {
+    token = null;
+    tokenExpiry = 0;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async getToken() {
+        // Return cached token if still valid (with 5-minute buffer)
+        if (this.token && Date.now() < this.tokenExpiry - 5 * 60_000) {
+            return this.token;
+        }
+        const signInUrl = `${this.config.adminApiUrl}/Auth/sign-in`;
+        const response = await fetch(signInUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                email: this.config.email,
+                password: this.config.password,
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Sign-in failed (${response.status}): ${errorText}`);
+        }
+        const data = await response.json();
+        const jwt = data.data || data.Data;
+        if (!jwt) {
+            throw new Error(`Sign-in response did not contain a token. Response: ${JSON.stringify(data)}`);
+        }
+        const expiry = parseJwtExpiry(jwt);
+        // Fallback: if expiry can't be parsed, cache for 23 hours
+        this.tokenExpiry = expiry > 0 ? expiry : Date.now() + 23 * 60 * 60_000;
+        this.token = jwt;
+        return this.token;
+    }
+    invalidate() {
+        this.token = null;
+        this.tokenExpiry = 0;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,0FAA0F;AAC1F,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CACxB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CACpD,CAAC;QACF,OAAO,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,OAAO,YAAY;IACf,KAAK,GAAkB,IAAI,CAAC;IAC5B,WAAW,GAAW,CAAC,CAAC;IACxB,MAAM,CAAa;IAE3B,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,4DAA4D;QAC5D,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,eAAe,CAAC;QAE5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;YACtC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;gBACxB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;aAC/B,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,GAAmB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QAEnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,uDAAuD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,0DAA0D;QAC1D,IAAI,CAAC,WAAW,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QACvE,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;QAEjB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/base-components.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Base (built-in) system components for WAP.
+ *
+ * These components are NOT stored in the backend API — they are hard-coded in
+ * the admin UI (elements.ts) and rendered by the web/mobile engine.
+ * Keeping them here lets the MCP answer schema questions without an API call,
+ * and gives you one place to update their definitions.
+ *
+ * isMobile: true  → available in BOTH web and mobile builders
+ * isMobile: false → web builder only
+ */
+export interface BaseProp {
+    name: string;
+    title: string;
+    type: string;
+    description?: string;
+    required?: boolean;
+    options?: {
+        label: string;
+        value: unknown;
+    }[];
+    props?: BaseProp[];
+}
+export interface BaseComponent {
+    /** kebab-case name — also used as the lookup key */
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    type: "element" | "wrapper";
+    droppable: boolean;
+    icon: string;
+    /** true = also available in mobile builder; false = web only */
+    isMobile: boolean;
+    definition: {
+        props: BaseProp[];
+        groups?: {
+            title: string;
+            props: BaseProp[];
+        }[];
+        defaults?: Record<string, unknown>;
+        preview?: {
+            type: string;
+            value: string;
+            suffix?: string;
+        };
+    };
+}
+export declare const BASE_COMPONENTS: BaseComponent[];
+/** Lookup by id/name (case-insensitive) */
+export declare function findBaseComponent(nameOrId: string): BaseComponent | undefined;
+//# sourceMappingURL=base-components.d.ts.map

package/dist/base-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-components.d.ts","sourceRoot":"","sources":["../src/base-components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC9C,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE;QACV,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;SAAE,EAAE,CAAC;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5D,CAAC;CACH;AAiOD,eAAO,MAAM,eAAe,EAAE,aAAa,EAuU1C,CAAC;AAEF,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAG7E"}