npm - bricks-builder-mcp - Versions diffs - 3.4.0 → 3.5.1 - Mend

bricks-builder-mcp 3.4.0 → 3.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/package.json +1 -1
package/server.js +425 -5

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "bricks-builder-mcp",
-  "version": "3.4.0",
+  "version": "3.5.1",
   "description": "Serveur MCP pour piloter Bricks Builder (WordPress) depuis Claude — édition de pages, gestion d'éléments, réordonnancement des sections.",
   "main": "server.js",
   "bin": {

package/server.js CHANGED Viewed

@@ -250,7 +250,7 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "update_element",
-        description: "Modifie UN SEUL élément sans recharger/renvoyer toute la page. Ultra économe en tokens. Utilise pour changer une couleur, un texte, etc.",
+        description: "Modifie UN SEUL élément sans recharger/renvoyer toute la page. Ultra économe en tokens. Utilise pour changer une couleur, un texte, etc. Permet aussi de renommer l'élément dans la structure Bricks via le paramètre `label`.",
         inputSchema: {
           type: "object",
           properties: {
@@ -264,10 +264,14 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             newSettings: {
               type: "object",
-              description: "Les nouveaux settings (fusionnés avec les anciens)",
+              description: "Les nouveaux settings (fusionnés avec les anciens). Optionnel si label est fourni seul.",
+            },
+            label: {
+              type: "string",
+              description: "Nom affiché dans la structure du builder Bricks (ex: 'Hero Section', 'Header Pill', 'Logo', 'CTA Buttons'). Modifie l'attribut `label` au niveau racine de l'élément. Optionnel.",
             },
           },
-          required: ["pageId", "elementId", "newSettings"],
+          required: ["pageId", "elementId"],
         },
       },
@@ -532,6 +536,261 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["name", "hex"],
         },
       },
+      // ===== OUTILS v3.5.0 — PHASE A : INSPECTION + CUSTOM CODE + FONTS + CODE EXEC =====
+      {
+        name: "list_bricks_options",
+        description: "Dump TOUTES les options WP commençant par 'bricks_'. Outil debug essentiel pour cartographier ce qui existe en base avant de modifier. Retourne nom, type, taille, aperçu de chaque option.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "get_bricks_option",
+        description: "Récupère une option Bricks spécifique en intégralité (sans tronquer). Le nom doit commencer par 'bricks_'.",
+        inputSchema: {
+          type: "object",
+          properties: { name: { type: "string", description: "Nom de l'option (ex: 'bricks_global_settings')" } },
+          required: ["name"],
+        },
+      },
+      {
+        name: "get_custom_code",
+        description: "Récupère le custom code global Bricks (CSS injecté dans <head>, scripts header, body header, body footer). C'est l'endroit natif pour charger Google Fonts via <link>.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "set_custom_code",
+        description: "Met à jour le custom code global Bricks. customScriptsHeader est l'endroit IDÉAL pour charger Google Fonts via <link rel='stylesheet'>. Seuls les champs fournis sont modifiés.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            customCss:               { type: "string", description: "CSS injecté dans <head>" },
+            customScriptsHeader:     { type: "string", description: "HTML/scripts injectés dans <head> (idéal pour Google Fonts <link>)" },
+            customScriptsBodyHeader: { type: "string", description: "HTML injecté juste après l'ouverture <body>" },
+            customScriptsBodyFooter: { type: "string", description: "HTML injecté juste avant </body>" },
+          },
+        },
+      },
+      {
+        name: "get_code_execution_status",
+        description: "État de l'exécution des code elements Bricks. Bricks 1.9.7+ désactive code execution par défaut pour sécurité. À vérifier avant de tenter d'utiliser <script>/<svg> inline dans un code element.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "set_code_execution",
+        description: "Active/désactive l'exécution des code elements Bricks + définit les rôles autorisés. Active la capability WP 'bricks_execute_code'. Note: Bricks exige aussi des code signatures valides côté builder.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            enabled: { type: "boolean", description: "true pour activer, false pour désactiver" },
+            roles:   { type: "array", items: { type: "string" }, description: "Rôles autorisés à exécuter du code (ex: ['administrator'])" },
+          },
+          required: ["enabled"],
+        },
+      },
+      {
+        name: "list_custom_fonts",
+        description: "Liste les custom fonts enregistrées dans Bricks Font Manager (CPT bricks_fonts).",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "register_custom_font",
+        description: "Enregistre une custom font dans Bricks Font Manager. Une fois enregistrée, elle sera dispo dans les selects font-family. Utiliser cet outil quand on a déjà les URLs des fichiers .woff2.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name:       { type: "string", description: "Nom de la font (ex: 'Anton')" },
+            fontFamily: { type: "string", description: "font-family CSS (souvent identique au name)" },
+            faces:      { type: "array", items: { type: "object" }, description: "Variantes : [{ weight: 400, style: 'normal', url: 'https://.../font-regular.woff2' }, ...]" },
+          },
+          required: ["name", "faces"],
+        },
+      },
+      {
+        name: "delete_custom_font",
+        description: "Supprime une custom font du Font Manager Bricks.",
+        inputSchema: {
+          type: "object",
+          properties: { id: { type: "number", description: "ID du post bricks_fonts à supprimer" } },
+          required: ["id"],
+        },
+      },
+      {
+        name: "register_google_font_locally",
+        description: "Télécharge un Google Font et l'enregistre dans le Font Manager Bricks. Récupère automatiquement les URLs des .woff2 depuis Google Fonts CSS et crée le post bricks_fonts. C'est la méthode native pour utiliser une Google Font dans Bricks.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name:    { type: "string", description: "Nom de la font Google (ex: 'Anton', 'Inter', 'Bebas Neue')" },
+            weights: { type: "array", items: { type: "number" }, description: "Poids souhaités (défaut: [400], ex: [400, 700, 900])" },
+          },
+          required: ["name"],
+        },
+      },
+      // ===== OUTILS v3.5.0 — PHASE B : GLOBAL CLASSES + THEME STYLES + PAGE CODE =====
+      {
+        name: "list_global_classes",
+        description: "Liste les classes CSS globales Bricks réutilisables sur tout le site.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "create_global_class",
+        description: "Crée une classe CSS globale Bricks. Une fois créée, on peut l'appliquer à n'importe quel élément via _cssClasses pour réutiliser des styles partout.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name:     { type: "string", description: "Nom de la classe (ex: 'btn-primary', 'card')" },
+            settings: { type: "object", description: "Settings Bricks à appliquer (ex: { _typography: ..., _padding: ..., _background: ... })" },
+          },
+          required: ["name", "settings"],
+        },
+      },
+      {
+        name: "update_global_class",
+        description: "Modifie une classe globale par id. Tous les éléments qui utilisent cette classe seront affectés.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id:       { type: "string", description: "ID de la classe" },
+            name:     { type: "string", description: "Nouveau nom (optionnel)" },
+            settings: { type: "object", description: "Nouveaux settings (optionnel, remplace l'ancien)" },
+          },
+          required: ["id"],
+        },
+      },
+      {
+        name: "delete_global_class",
+        description: "Supprime une classe globale Bricks.",
+        inputSchema: {
+          type: "object",
+          properties: { id: { type: "string", description: "ID de la classe à supprimer" } },
+          required: ["id"],
+        },
+      },
+      {
+        name: "list_theme_styles",
+        description: "Liste les theme styles Bricks (styles globaux conditionnels appliqués selon contexte).",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "create_theme_style",
+        description: "Crée un theme style Bricks. Définit les styles par défaut globaux (typo, couleurs, buttons, etc.) avec conditions optionnelles d'application.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name:       { type: "string", description: "Nom du theme style" },
+            settings:   { type: "object", description: "Settings (typography, colors, headings, buttons, etc.)" },
+            conditions: { type: "array", items: { type: "object" }, description: "Conditions d'application (optionnel)" },
+          },
+          required: ["name", "settings"],
+        },
+      },
+      {
+        name: "update_theme_style",
+        description: "Modifie un theme style existant.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id:         { type: "string", description: "ID du theme style" },
+            name:       { type: "string", description: "Nouveau nom (opt)" },
+            settings:   { type: "object", description: "Nouveaux settings (opt)" },
+            conditions: { type: "array", items: { type: "object" }, description: "Nouvelles conditions (opt)" },
+          },
+          required: ["id"],
+        },
+      },
+      {
+        name: "delete_theme_style",
+        description: "Supprime un theme style.",
+        inputSchema: {
+          type: "object",
+          properties: { id: { type: "string", description: "ID du theme style" } },
+          required: ["id"],
+        },
+      },
+      {
+        name: "get_page_custom_code",
+        description: "Récupère le custom code (CSS/JS) spécifique à une page Bricks (Page Settings → Custom Code).",
+        inputSchema: {
+          type: "object",
+          properties: { pageId: { type: "number", description: "ID de la page" } },
+          required: ["pageId"],
+        },
+      },
+      {
+        name: "set_page_custom_code",
+        description: "Définit du CSS et/ou JS spécifique à une page (Page Settings → Custom Code). Utile pour des animations, des polices spécifiques à cette page seulement, etc.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageId:        { type: "number", description: "ID de la page" },
+            customCss:     { type: "string", description: "CSS de la page (sera injecté dans <head> uniquement sur cette page)" },
+            customScripts: { type: "string", description: "Scripts/HTML de la page (injectés dans <head>)" },
+          },
+          required: ["pageId"],
+        },
+      },
+      // ===== OUTILS v3.5.0 — PHASE C : STYLE MANAGER 2.2 + COMPONENTS =====
+      {
+        name: "list_typography_scales",
+        description: "Liste les typography scales globales Bricks (Style Manager 2.2). Définit des tailles de typo réutilisables pour h1, h2, body, etc.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "set_typography_scale",
+        description: "Crée ou met à jour une typography scale (Style Manager 2.2). Si id existe, met à jour ; sinon crée une nouvelle.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id:     { type: "string", description: "ID de la scale (laisser vide pour créer)" },
+            name:   { type: "string", description: "Nom de la scale (ex: 'Default')" },
+            values: { type: "object", description: "Valeurs (ex: { h1: '64px', h2: '48px', body: '16px' })" },
+          },
+        },
+      },
+      {
+        name: "list_spacing_scales",
+        description: "Liste les spacing scales globales Bricks (Style Manager 2.2).",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "set_spacing_scale",
+        description: "Crée ou met à jour une spacing scale.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id:     { type: "string", description: "ID de la scale (laisser vide pour créer)" },
+            name:   { type: "string", description: "Nom de la scale" },
+            values: { type: "object", description: "Valeurs (ex: { xs: '8px', sm: '16px', md: '24px', lg: '48px' })" },
+          },
+        },
+      },
+      {
+        name: "list_css_variables",
+        description: "Liste les CSS variables globales Bricks (Style Manager 2.2). Variables réutilisables comme --primary, --accent, etc.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "set_css_variable",
+        description: "Crée ou met à jour une CSS variable globale. Si la variable existe, sa valeur est mise à jour ; sinon elle est créée.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name:  { type: "string", description: "Nom (avec ou sans --, ex: '--primary' ou 'primary')" },
+            value: { type: "string", description: "Valeur (ex: '#FD5B2C', '64px', '1.5')" },
+          },
+          required: ["name", "value"],
+        },
+      },
+      {
+        name: "list_components",
+        description: "Liste les components Bricks (templates avec type=component, Bricks 2.x).",
+        inputSchema: { type: "object", properties: {} },
+      },
     ],
   };
 });
@@ -610,11 +869,12 @@ mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
       case "update_element":
         console.error(`[LOG] Exécution: update_element`);
-        console.error(`[LOG] Modification de l'élément ${args.elementId}`);
+        console.error(`[LOG] Modification de l'élément ${args.elementId}${args.label ? ` (label: "${args.label}")` : ''}`);
         result = await callWordPressAPI("/update-element", "POST", {
           pageId: args.pageId,
           elementId: args.elementId,
-          newSettings: args.newSettings,
+          newSettings: args.newSettings || {},
+          label: args.label,
         });
         break;
@@ -780,6 +1040,166 @@ mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
         });
         break;
+      // ===== OUTILS v3.5.0 — PHASE A : INSPECTION + CUSTOM CODE + FONTS + CODE EXEC =====
+      case "list_bricks_options":
+        result = await callWordPressAPI("/list-bricks-options", "GET");
+        break;
+      case "get_bricks_option":
+        result = await callWordPressAPI("/get-bricks-option", "POST", { name: args.name });
+        break;
+      case "get_custom_code":
+        result = await callWordPressAPI("/get-custom-code", "GET");
+        break;
+      case "set_custom_code":
+        result = await callWordPressAPI("/set-custom-code", "POST", {
+          customCss: args.customCss,
+          customScriptsHeader: args.customScriptsHeader,
+          customScriptsBodyHeader: args.customScriptsBodyHeader,
+          customScriptsBodyFooter: args.customScriptsBodyFooter,
+        });
+        break;
+      case "get_code_execution_status":
+        result = await callWordPressAPI("/get-code-execution-status", "GET");
+        break;
+      case "set_code_execution":
+        result = await callWordPressAPI("/set-code-execution", "POST", {
+          enabled: args.enabled,
+          roles: args.roles || [],
+        });
+        break;
+      case "list_custom_fonts":
+        result = await callWordPressAPI("/list-custom-fonts", "GET");
+        break;
+      case "register_custom_font":
+        result = await callWordPressAPI("/register-custom-font", "POST", {
+          name: args.name,
+          fontFamily: args.fontFamily || args.name,
+          faces: args.faces,
+        });
+        break;
+      case "delete_custom_font":
+        result = await callWordPressAPI("/delete-custom-font", "POST", { id: args.id });
+        break;
+      case "register_google_font_locally":
+        result = await callWordPressAPI("/register-google-font-locally", "POST", {
+          name: args.name,
+          weights: args.weights || [400],
+        });
+        break;
+      // ===== OUTILS v3.5.0 — PHASE B : GLOBAL CLASSES + THEME STYLES + PAGE CODE =====
+      case "list_global_classes":
+        result = await callWordPressAPI("/list-global-classes", "GET");
+        break;
+      case "create_global_class":
+        result = await callWordPressAPI("/create-global-class", "POST", {
+          name: args.name,
+          settings: args.settings || {},
+        });
+        break;
+      case "update_global_class":
+        result = await callWordPressAPI("/update-global-class", "POST", {
+          id: args.id,
+          name: args.name,
+          settings: args.settings,
+        });
+        break;
+      case "delete_global_class":
+        result = await callWordPressAPI("/delete-global-class", "POST", { id: args.id });
+        break;
+      case "list_theme_styles":
+        result = await callWordPressAPI("/list-theme-styles", "GET");
+        break;
+      case "create_theme_style":
+        result = await callWordPressAPI("/create-theme-style", "POST", {
+          name: args.name,
+          settings: args.settings || {},
+          conditions: args.conditions || [],
+        });
+        break;
+      case "update_theme_style":
+        result = await callWordPressAPI("/update-theme-style", "POST", {
+          id: args.id,
+          name: args.name,
+          settings: args.settings,
+          conditions: args.conditions,
+        });
+        break;
+      case "delete_theme_style":
+        result = await callWordPressAPI("/delete-theme-style", "POST", { id: args.id });
+        break;
+      case "get_page_custom_code":
+        result = await callWordPressAPI("/get-page-custom-code", "POST", { pageId: args.pageId });
+        break;
+      case "set_page_custom_code":
+        result = await callWordPressAPI("/set-page-custom-code", "POST", {
+          pageId: args.pageId,
+          customCss: args.customCss,
+          customScripts: args.customScripts,
+        });
+        break;
+      // ===== OUTILS v3.5.0 — PHASE C : STYLE MANAGER 2.2 + COMPONENTS =====
+      case "list_typography_scales":
+        result = await callWordPressAPI("/list-typography-scales", "GET");
+        break;
+      case "set_typography_scale":
+        result = await callWordPressAPI("/set-typography-scale", "POST", {
+          id: args.id,
+          name: args.name,
+          values: args.values || {},
+        });
+        break;
+      case "list_spacing_scales":
+        result = await callWordPressAPI("/list-spacing-scales", "GET");
+        break;
+      case "set_spacing_scale":
+        result = await callWordPressAPI("/set-spacing-scale", "POST", {
+          id: args.id,
+          name: args.name,
+          values: args.values || {},
+        });
+        break;
+      case "list_css_variables":
+        result = await callWordPressAPI("/list-css-variables", "GET");
+        break;
+      case "set_css_variable":
+        result = await callWordPressAPI("/set-css-variable", "POST", {
+          name: args.name,
+          value: args.value,
+        });
+        break;
+      case "list_components":
+        result = await callWordPressAPI("/list-components", "GET");
+        break;
       default:
         console.error(`[LOG] Tool inconnu: ${name}`);
         result = { error: `Tool ${name} not found` };