bricks-builder-mcp 3.7.4 → 3.8.0

package/README.md

@@ -24,21 +24,39 @@ Tu installes **2 choses** :
 
 ---
 
-## Installation
+## Installation — La méthode recommandée (Cowork, 1 clic)
 
-Choisis ton chemin selon l'app que tu utilises :
+C'est la méthode **complète et la plus simple**. Tu obtiens : les outils MCP **+ le skill embarqué** (doc, règles d'or, patterns Bricks 2.3, cheat-sheets, etc.) — Claude est immédiatement opérationnel.
 
-### Option A — Cowork (1 clic, recommandé pour les non-devs)
-
-1. **Installe le plugin WordPress** : télécharge le `.zip` depuis les **[Releases GitHub](https://github.com/Scott1012/bricks-builder-mcp/releases)** → WP admin → Extensions → Téléverser → Activer
-2. Dans WP admin → **Bricks MCP** → clique sur **"Télécharger pour Claude"**. Tu reçois un fichier `.plugin` qui contient TOUT : config MCP (URL + clé API auto-générée) + skill + doc embarqués
+1. **Installe le plugin WordPress** : télécharge le `.zip` depuis les **[Releases GitHub](https://github.com/Scott1012/bricks-builder-mcp/releases)** → WP admin → Extensions → Ajouter → Téléverser → Activer
+2. Dans WP admin → **Bricks MCP** → clique sur **"Télécharger pour Claude"**. Tu reçois un fichier `.plugin` qui contient tout : config MCP (URL + clé API auto-générée) + skill + doc
 3. Glisse ce `.plugin` dans la fenêtre Cowork → Activate
 
 C'est fini. Aucun terminal, aucun JSON à éditer.
 
-### Option B — Claude Desktop / Claude Code
+### (Optionnel mais recommandé) Activer `verify_element`
+
+Dans un terminal, une seule fois :
+
+```bash
+npx playwright install chromium
+```
+
+Ça télécharge Chromium (~130 Mo) pour que Claude puisse prendre des screenshots de tes pages et vérifier le rendu visuellement.
+
+### Test final
+
+Demande à Claude : *"Liste les pages Bricks de mon site"*. Si ça répond, tout marche.
 
-1. **Installe le plugin WordPress** : pareil que ci-dessus (étape 1 de l'Option A)
+---
+
+## Méthode alternative — Claude Desktop / Claude Code (config manuelle)
+
+> ⚠️ **À savoir** : cette méthode te donne accès **aux outils MCP** mais pas au **skill** (doc + règles d'or + patterns). Claude doit deviner les bonnes pratiques sans la doc, ce qui multiplie les erreurs en construction.
+>
+> **Recommandé** : utilise plutôt la méthode Cowork ci-dessus, ou bien clone le repo skill localement (voir plus bas).
+
+1. **Installe le plugin WordPress** : pareil que ci-dessus (étape 1 de la méthode recommandée)
 2. **Génère ta clé API** : WP admin → **Bricks MCP** → "Générer une clé API" → copie-la (`bricks_...`)
 3. **Édite ton `claude_desktop_config.json`** (Cmd+, dans Claude Desktop → Developer → Edit Config) :
 
@@ -59,19 +77,15 @@ C'est fini. Aucun terminal, aucun JSON à éditer.
 
 4. **Redémarre Claude Desktop**.
 
-### (Optionnel mais recommandé) Activer `verify_element`
-
-Cette commande télécharge Chromium (~130 Mo) pour que Claude puisse vérifier visuellement le rendu de tes pages :
+### Pour récupérer le skill manuellement (Claude Code uniquement)
 
 ```bash
-npx playwright install chromium
+curl -L https://github.com/Scott1012/bricks-builder-mcp/archive/main.tar.gz | tar -xz -C /tmp && \
+  mkdir -p ~/.claude/skills && \
+  cp -r /tmp/bricks-builder-mcp-main/skill ~/.claude/skills/bricks-builder
 ```
 
-À lancer une seule fois, dans n'importe quel terminal.
-
-### Test final
-
-Demande à Claude : *"Liste les pages Bricks de mon site"*. Si ça répond, tout marche.
+Claude Code détectera automatiquement le skill au prochain démarrage.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "bricks-builder-mcp",
-  "version": "3.7.4",
+  "version": "3.8.0",
   "description": "Serveur MCP pour piloter Bricks Builder (WordPress) depuis Claude — édition de pages, gestion d'éléments, réordonnancement des sections, vérification visuelle (verify_element), upload optimisé WebP. Communauté Discord : https://discord.gg/rX22zHRzH",
   "homepage": "https://discord.gg/rX22zHRzH",
   "main": "server.js",

package/server.js

@@ -1102,6 +1102,21 @@ mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
         },
       },
 
+      // ===== v3.7.0 — SKILL VERSIONING =====
+      {
+        name: "check_skill_version",
+        description: "⭐ À APPELER AU DÉBUT DE CHAQUE CONVERSATION BRICKS. Compare ta version locale du skill (lue dans le frontmatter de SKILL.md, champ `version`) avec la version actuelle côté serveur. Si décalage, prévenir l'utilisateur de re-télécharger le .plugin depuis WP admin → Bricks MCP.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            localVersion: {
+              type: "string",
+              description: "Version skill locale (ex: '1.0.0'), lue depuis le frontmatter du SKILL.md chargé dans ton contexte",
+            },
+          },
+        },
+      },
+
       // ===== v3.6.0 — UPLOAD MEDIA BATCH =====
       {
         name: "upload_media_batch",
@@ -1825,6 +1840,13 @@ mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
         });
         break;
 
+      // ===== v3.7.0 — SKILL VERSIONING =====
+      case "check_skill_version": {
+        const qs = args.localVersion ? `?localVersion=${encodeURIComponent(args.localVersion)}` : "";
+        result = await callWordPressAPI("/skill-version" + qs, "GET");
+        break;
+      }
+
       // ===== v3.7.0 — UPLOAD FROM LOCAL FILESYSTEM =====
       case "upload_local_file": {
         try {