bricks-builder-mcp 3.1.1 → 3.4.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "bricks-builder-mcp",
-  "version": "3.1.1",
+  "version": "3.4.0",
   "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

@@ -356,6 +356,182 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["pageId", "orderedIds"],
         },
       },
+
+      // ===== OUTIL v3.2.0 — CRÉATION DE PAGES =====
+
+      {
+        name: "create_page",
+        description: "Crée une nouvelle page WordPress et l'active immédiatement en mode Bricks Builder. Utilise pour démarrer un nouveau site ou ajouter une page (Accueil, Services, Contact, etc.). Renvoie l'ID de la page créée, prêt à être utilisé avec les autres outils MCP.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            title: {
+              type: "string",
+              description: "Titre de la page (ex: 'Accueil', 'Services', 'Contact')",
+            },
+            slug: {
+              type: "string",
+              description: "Slug URL optionnel (ex: 'accueil'). Si omis, sera généré depuis le titre.",
+            },
+            status: {
+              type: "string",
+              enum: ["publish", "draft", "private"],
+              description: "Statut de publication (défaut: 'publish')",
+            },
+            setAsHomepage: {
+              type: "boolean",
+              description: "Si true, configure cette page comme page d'accueil du site (défaut: false)",
+            },
+          },
+          required: ["title"],
+        },
+      },
+
+      // ===== OUTILS v3.3.0 — GESTION DES PAGES =====
+
+      {
+        name: "delete_page",
+        description: "Supprime une page WordPress. Par défaut la met à la corbeille (récupérable). Utilise force=true pour supprimer définitivement (irréversible). Refuse de supprimer la page d'accueil active — la changer d'abord.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageId: { type: "number", description: "L'ID de la page à supprimer" },
+            force: { type: "boolean", description: "Si true, suppression définitive. Sinon, mise à la corbeille (défaut: false)" },
+          },
+          required: ["pageId"],
+        },
+      },
+      {
+        name: "update_page_meta",
+        description: "Met à jour les méta-données d'une page (titre, slug URL, statut de publication, page parente). Seuls les champs fournis sont modifiés. Utile pour renommer, changer l'URL, publier un draft, organiser la hiérarchie.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageId: { type: "number", description: "L'ID de la page à modifier" },
+            title: { type: "string", description: "Nouveau titre (optionnel)" },
+            slug: { type: "string", description: "Nouveau slug URL (optionnel, ex: 'accueil')" },
+            status: { type: "string", enum: ["publish", "draft", "private", "pending"], description: "Nouveau statut de publication (optionnel)" },
+            parentId: { type: "number", description: "ID de la page parente (0 = racine, optionnel)" },
+          },
+          required: ["pageId"],
+        },
+      },
+      {
+        name: "duplicate_page",
+        description: "Duplique une page existante avec son contenu Bricks complet (sections, éléments, settings). Très utile pour créer des variantes à partir d'une page bien faite, ou pour partir d'un template existant. La copie est créée en draft par défaut.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            sourcePageId: { type: "number", description: "ID de la page source à dupliquer" },
+            newTitle: { type: "string", description: "Titre de la copie (optionnel, défaut: 'Copie de {original}')" },
+            status: { type: "string", enum: ["publish", "draft", "private", "pending"], description: "Statut de la copie (défaut: 'draft')" },
+          },
+          required: ["sourcePageId"],
+        },
+      },
+      {
+        name: "set_homepage",
+        description: "Définit une page comme page d'accueil du site WordPress. La page doit être publiée. Pour réinitialiser sur les derniers articles (mode WordPress par défaut), passer reset=true.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageId: { type: "number", description: "ID de la page à mettre en accueil" },
+            reset: { type: "boolean", description: "Si true, reset sur les derniers articles (pageId ignoré)" },
+          },
+        },
+      },
+
+      // ===== OUTILS v3.4.0 — HEALTH, MÉDIAS, MENUS, STYLES GLOBAUX =====
+
+      {
+        name: "health_check",
+        description: "Test de connexion au site WordPress + infos système (versions plugin/WP/PHP/Bricks, multisite, URL). Utile pour debug et confirmer qu'on parle au bon site.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "list_all_pages",
+        description: "Liste TOUTES les pages WordPress du site (pas seulement celles avec contenu Bricks). Inclut les pages WP standard. Utile pour avoir l'inventaire complet avant de créer/dupliquer/nettoyer.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "upload_media",
+        description: "Télécharge une image depuis une URL et l'ajoute à la médiathèque WordPress. Renvoie l'URL WP de l'image, prête à utiliser dans les éléments Bricks (image, background, etc.). Très utile pour intégrer des photos client sans passer par la médiathèque WP manuellement.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            sourceUrl: { type: "string", description: "URL publique de l'image à télécharger (jpg/png/webp/gif/svg)" },
+            title: { type: "string", description: "Titre de l'image dans la médiathèque (optionnel)" },
+            alt: { type: "string", description: "Alt text pour SEO/accessibilité (optionnel mais fortement recommandé)" },
+            caption: { type: "string", description: "Légende affichée sous l'image (optionnel)" },
+          },
+          required: ["sourceUrl"],
+        },
+      },
+      {
+        name: "list_media",
+        description: "Liste paginée des médias de la médiathèque WordPress avec leurs URLs. Filtrable par recherche. Utile pour retrouver des images déjà uploadées.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            page: { type: "number", description: "Page de pagination (défaut: 1)" },
+            perPage: { type: "number", description: "Nombre par page (défaut: 20, max: 100)" },
+            search: { type: "string", description: "Recherche textuelle dans les titres/noms de fichier" },
+          },
+        },
+      },
+      {
+        name: "list_menus",
+        description: "Liste les menus de navigation WordPress du site avec leur nombre d'items et les emplacements assignés (header, footer, etc.). À utiliser avant add_menu_item.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "add_menu_item",
+        description: "Ajoute un item à un menu WordPress de navigation. Soit on lie une page existante (via pageId), soit un lien custom (via customUrl + label). Très utile pour ajouter automatiquement les nouvelles pages au menu principal.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            menuId: { type: "number", description: "ID du menu (cf list_menus)" },
+            pageId: { type: "number", description: "ID de la page à ajouter (mode 'page')" },
+            customUrl: { type: "string", description: "URL custom (mode 'lien externe')" },
+            label: { type: "string", description: "Libellé visible. Si pageId fourni, par défaut prend le titre de la page" },
+            parentItemId: { type: "number", description: "Mettre cet item comme enfant d'un autre item (sous-menu)" },
+          },
+          required: ["menuId"],
+        },
+      },
+      {
+        name: "get_global_styles",
+        description: "Récupère les settings globaux de Bricks Builder pour ce site (typographie globale, breakpoints, palette, classes globales, theme styles). Utile au début d'un projet pour comprendre la base visuelle existante.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "update_global_styles",
+        description: "Met à jour les settings globaux Bricks via fusion récursive. Utile pour appliquer une typo de site ou une convention CSS partout d'un coup. Seuls les champs fournis sont modifiés.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            settings: { type: "object", description: "Settings à fusionner avec l'existant" },
+          },
+          required: ["settings"],
+        },
+      },
+      {
+        name: "list_color_palette",
+        description: "Récupère la palette de couleurs globale Bricks (les couleurs nommées réutilisables sur tout le site).",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "add_color_to_palette",
+        description: "Ajoute une couleur à la palette globale Bricks. Permet ensuite de l'utiliser dans n'importe quel élément via son ID/nom plutôt que de répéter la valeur hex partout.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: { type: "string", description: "Nom de la couleur (ex: 'Primaire', 'Accent orange')" },
+            hex: { type: "string", description: "Valeur hexadécimale (ex: '#ff6b35' ou 'ff6b35')" },
+          },
+          required: ["name", "hex"],
+        },
+      },
     ],
   };
 });
@@ -482,6 +658,128 @@ mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
         });
         break;
 
+      // ===== OUTIL v3.2.0 — CRÉATION DE PAGES =====
+
+      case "create_page":
+        console.error(`[LOG] Exécution: create_page avec title="${args.title}"`);
+        result = await callWordPressAPI("/create-page", "POST", {
+          title: args.title,
+          slug: args.slug || "",
+          status: args.status || "publish",
+          setAsHomepage: args.setAsHomepage || false,
+        });
+        break;
+
+      // ===== OUTILS v3.3.0 — GESTION DES PAGES =====
+
+      case "delete_page":
+        console.error(`[LOG] Exécution: delete_page pageId=${args.pageId} force=${args.force}`);
+        result = await callWordPressAPI("/delete-page", "POST", {
+          pageId: args.pageId,
+          force: args.force || false,
+        });
+        break;
+
+      case "update_page_meta":
+        console.error(`[LOG] Exécution: update_page_meta pageId=${args.pageId}`);
+        result = await callWordPressAPI("/update-page-meta", "POST", {
+          pageId: args.pageId,
+          title: args.title,
+          slug: args.slug,
+          status: args.status,
+          parentId: args.parentId,
+        });
+        break;
+
+      case "duplicate_page":
+        console.error(`[LOG] Exécution: duplicate_page source=${args.sourcePageId}`);
+        result = await callWordPressAPI("/duplicate-page", "POST", {
+          sourcePageId: args.sourcePageId,
+          newTitle: args.newTitle || "",
+          status: args.status || "draft",
+        });
+        break;
+
+      case "set_homepage":
+        console.error(`[LOG] Exécution: set_homepage pageId=${args.pageId} reset=${args.reset}`);
+        result = await callWordPressAPI("/set-homepage", "POST", {
+          pageId: args.pageId,
+          reset: args.reset || false,
+        });
+        break;
+
+      // ===== OUTILS v3.4.0 — HEALTH, MÉDIAS, MENUS, STYLES GLOBAUX =====
+
+      case "health_check":
+        console.error(`[LOG] Exécution: health_check`);
+        result = await callWordPressAPI("/health", "GET");
+        break;
+
+      case "list_all_pages":
+        console.error(`[LOG] Exécution: list_all_pages`);
+        result = await callWordPressAPI("/list-all-pages", "GET");
+        break;
+
+      case "upload_media":
+        console.error(`[LOG] Exécution: upload_media depuis ${args.sourceUrl}`);
+        result = await callWordPressAPI("/upload-media", "POST", {
+          sourceUrl: args.sourceUrl,
+          title: args.title,
+          alt: args.alt,
+          caption: args.caption,
+        });
+        break;
+
+      case "list_media":
+        console.error(`[LOG] Exécution: list_media page=${args.page} perPage=${args.perPage}`);
+        result = await callWordPressAPI("/list-media", "POST", {
+          page: args.page || 1,
+          perPage: args.perPage || 20,
+          search: args.search,
+        });
+        break;
+
+      case "list_menus":
+        console.error(`[LOG] Exécution: list_menus`);
+        result = await callWordPressAPI("/list-menus", "GET");
+        break;
+
+      case "add_menu_item":
+        console.error(`[LOG] Exécution: add_menu_item menuId=${args.menuId}`);
+        result = await callWordPressAPI("/add-menu-item", "POST", {
+          menuId: args.menuId,
+          pageId: args.pageId,
+          customUrl: args.customUrl,
+          label: args.label,
+          parentItemId: args.parentItemId,
+        });
+        break;
+
+      case "get_global_styles":
+        console.error(`[LOG] Exécution: get_global_styles`);
+        result = await callWordPressAPI("/get-global-styles", "GET");
+        break;
+
+      case "update_global_styles":
+        console.error(`[LOG] Exécution: update_global_styles`);
+        result = await callWordPressAPI("/update-global-styles", "POST", {
+          settings: args.settings || {},
+        });
+        break;
+
+      case "list_color_palette":
+        console.error(`[LOG] Exécution: list_color_palette`);
+        result = await callWordPressAPI("/list-color-palette", "GET");
+        break;
+
+      case "add_color_to_palette":
+        console.error(`[LOG] Exécution: add_color_to_palette name="${args.name}"`);
+        result = await callWordPressAPI("/add-color-to-palette", "POST", {
+          name: args.name,
+          hex: args.hex,
+        });
+        break;
+
       default:
         console.error(`[LOG] Tool inconnu: ${name}`);
         result = { error: `Tool ${name} not found` };