story-theme-mcp 1.0.0 → 1.1.0

package/README.md

@@ -13,7 +13,9 @@ IA   : couleurs, polices, accueil de 9 sections, fiche produit, collection, page
 
 ## Installation
 
-Node 20 ou plus ([nodejs.org](https://nodejs.org)).
+**Le plus simple — l'extension Claude.** Téléchargez `story-theme-mcp.mcpb` depuis votre espace membre (page MCP & Appli) et ouvrez le fichier : Claude installe le serveur et vous demande votre jeton dans un formulaire. Rien d'autre à installer, Node compris.
+
+Les deux méthodes ci-dessous restent valables si vous préférez configurer à la main. Elles demandent Node 20 ou plus ([nodejs.org](https://nodejs.org)).
 
 **Claude (application)** — Réglages > Développeur > Modifier la configuration, puis dans `claude_desktop_config.json` :
 
@@ -102,8 +104,11 @@ Pas de connexion à une boutique : le MCP fabrique un thème à importer, il ne
 npm test          # validateur, presets, recettes, couleurs, polices, projets, export, source, serveur MCP
 npm run check     # après une mise à jour du thème : presets, recettes et descriptions toujours valides ?
 npm run fonts     # recharge la bibliothèque de polices Shopify (shopify.dev)
+npm run bundle    # fabrique build/story-theme-mcp-<version>.mcpb (extension Claude, un clic)
 ```
 
+Après `npm run bundle`, déposer le `.mcpb` dans le dossier `mcp/` de l'espace membre : la page MCP & Appli sert automatiquement la version la plus récente qu'elle y trouve.
+
 Avec `STORY_THEME_DIR` sur le dépôt du thème, le MCP lit le thème en cours d'écriture et n'appelle pas l'espace membre. Les connaissances rédigées à la main vivent dans `src/knowledge/` ; tout le reste vient du thème.
 
 Publication : `npm version <x.y.z>` (mettre à jour `src/version.js` à l'identique), `npm publish` — `prepublishOnly` vérifie l'ensemble.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "story-theme-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Serveur MCP du Story Thème : votre assistant IA connaît le thème Shopify Story par cœur et construit des boutiques propres et professionnelles.",
   "type": "module",
   "main": "src/index.js",
@@ -15,7 +15,8 @@
     "test": "node --test test/*.test.js",
     "check": "node scripts/check-theme.js",
     "fonts": "node scripts/fetch-fonts.js",
-    "prepublishOnly": "npm test && node scripts/check-release.js"
+    "prepublishOnly": "npm test && node scripts/check-release.js",
+    "bundle": "node scripts/build-bundle.js"
   },
   "author": "New Story (SAS NS GROUP) <contact@story-theme.com>",
   "license": "SEE LICENSE IN LICENSE",
@@ -42,5 +43,8 @@
     "src",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "devDependencies": {
+    "express": "^5.2.1"
+  }
 }

package/src/http.js

@@ -0,0 +1,147 @@
+// =====================================================================
+// Le même MCP, servi en HTTP — pour les connecteurs distants
+// =====================================================================
+//
+// L'extension .mcpb installe le serveur CHEZ le client : Claude prévient alors, à raison, que
+// le programme aura accès à tout son ordinateur. Un connecteur distant ne s'installe pas — on
+// colle une adresse, on clique « Se connecter », et rien ne descend sur la machine. C'est aussi
+// la seule forme que ChatGPT accepte.
+//
+// Ce module ne réécrit rien : il prend le serveur MCP existant (src/server.js, ses 35 outils,
+// ses garde-fous) et le branche sur le transport HTTP du SDK. Ce qui change, c'est QUI parle :
+//
+//   stdio     un seul utilisateur, sa configuration vient des variables d'environnement
+//   HTTP      autant d'utilisateurs que de requêtes, chacun avec son compte, sa licence,
+//             ses projets — d'où `configPour(authInfo)`, appelé à chaque nouvelle session.
+//
+// Le thème, lui, est COMMUN : c'est la même version publiée pour tout le monde. Une seule
+// copie sur le serveur, partagée par toutes les sessions (voir `sourcePartagee`), au lieu d'un
+// téléchargement par client.
+
+import crypto from 'node:crypto';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer } from './server.js';
+
+/** En-tête de session du protocole : le client le renvoie à chaque requête suivante. */
+const ENTETE_SESSION = 'mcp-session-id';
+
+/**
+ * Une session MCP = un serveur + un transport, gardés en mémoire entre deux requêtes.
+ * Fermée au bout de `inactiviteMs` sans rien : un client qui ferme Claude ne laisse pas sa
+ * session ouverte indéfiniment.
+ */
+class Sessions {
+  constructor({ inactiviteMs = 30 * 60 * 1000, max = 500 } = {}) {
+    this.parId = new Map();
+    this.inactiviteMs = inactiviteMs;
+    this.max = max;
+  }
+
+  get(id) {
+    const session = this.parId.get(id);
+    if (session) session.vueA = Date.now();
+    return session;
+  }
+
+  set(id, session) {
+    this.parId.set(id, { ...session, vueA: Date.now() });
+    this.nettoyer();
+  }
+
+  supprimer(id) {
+    const session = this.parId.get(id);
+    if (!session) return;
+    this.parId.delete(id);
+    session.transport.close?.().catch(() => {});
+  }
+
+  /** Purge à l'écriture plutôt qu'au minuteur : pas de timer qui tourne dans le vide. */
+  nettoyer() {
+    const limite = Date.now() - this.inactiviteMs;
+    for (const [id, session] of this.parId) {
+      if (session.vueA < limite) this.supprimer(id);
+    }
+    // Garde-fou de dernier recours : au-delà du plafond, les plus anciennes partent.
+    if (this.parId.size > this.max) {
+      const triees = [...this.parId.entries()].sort((a, b) => a[1].vueA - b[1].vueA);
+      for (const [id] of triees.slice(0, this.parId.size - this.max)) this.supprimer(id);
+    }
+  }
+
+  get taille() {
+    return this.parId.size;
+  }
+}
+
+/**
+ * Le gestionnaire HTTP du MCP, à monter sur une route Express (POST, GET et DELETE).
+ *
+ * @param {object} options
+ * @param {(authInfo: object) => Promise<object>|object} options.configPour
+ *        Rend la configuration du serveur MCP pour l'utilisateur authentifié : sa langue, son
+ *        dossier de projets, la source du thème. C'est ici que l'espace membre vérifie la
+ *        licence — lever une erreur refuse la session.
+ * @param {object} [options.sessions] — remplaçable dans les tests
+ * @returns {{ handler: Function, sessions: Sessions }}
+ */
+export function createHttpHandler({ configPour, sessions = new Sessions() }) {
+  const handler = async (req, res) => {
+    const idSession = req.headers[ENTETE_SESSION];
+
+    // Requête suivante d'une session connue : on repasse au transport qui la porte.
+    if (idSession && sessions.get(idSession)) {
+      const { transport } = sessions.get(idSession);
+      if (req.method === 'DELETE') sessions.supprimer(idSession);
+      return transport.handleRequest(req, res, req.body);
+    }
+
+    // Un identifiant de session inconnu n'est pas une erreur du client : sa session a pu
+    // expirer pendant qu'il déjeunait. On le dit dans les termes du protocole, il rouvrira.
+    if (idSession) {
+      return res.status(404).json({
+        jsonrpc: '2.0',
+        error: { code: -32001, message: 'Session expirée. Reconnectez-vous.' },
+        id: null,
+      });
+    }
+
+    if (req.method !== 'POST') {
+      return res.status(405).json({
+        jsonrpc: '2.0',
+        error: { code: -32000, message: 'Method Not Allowed' },
+        id: null,
+      });
+    }
+
+    // Nouvelle session : c'est le seul moment où l'on regarde qui parle.
+    let config;
+    try {
+      config = await configPour(req.auth);
+    } catch (error) {
+      return res.status(403).json({
+        jsonrpc: '2.0',
+        error: { code: -32000, message: error.message },
+        id: null,
+      });
+    }
+
+    const transport = new StreamableHTTPServerTransport({
+      sessionIdGenerator: () => crypto.randomUUID(),
+      onsessioninitialized: (id) => sessions.set(id, { transport, server }),
+      // JSON plutôt que SSE : nos outils répondent d'un coup, aucun ne diffuse en continu.
+      enableJsonResponse: true,
+    });
+
+    const server = createServer(config);
+    transport.onclose = () => {
+      if (transport.sessionId) sessions.supprimer(transport.sessionId);
+    };
+
+    await server.connect(transport);
+    return transport.handleRequest(req, res, req.body);
+  };
+
+  return { handler, sessions };
+}
+
+export { Sessions };

package/src/server.js

@@ -26,6 +26,7 @@ import { GUIDES, GUIDE_TOPICS } from './knowledge/guides.js';
 import { RECIPES, findRecipe } from './knowledge/recipes.js';
 import { FONT_PAIRINGS, searchFonts, checkFontHandle, fontInfo, FONT_LIBRARY } from './knowledge/fonts.js';
 import { ok, fail, parseContent, formatSettings, formatValidation, formatFindings } from './format.js';
+import { registerShopTools } from './shops/tools.js';
 
 export { VERSION } from './version.js';
 import { VERSION } from './version.js';
@@ -257,6 +258,7 @@ export function createServer(config) {
           '- Construire : create_project, update_brief, apply_recipe, localize_template, list_texts, edit_template, write_file, update_theme_settings, read_file, exclude_template',
           '- Contrôler : validate_json, review_project, undo, revert_file',
           '- Livrer : export_theme (zip + check-list) ; import_theme pour auditer un thème exporté d’une boutique',
+          '- Vos boutiques en direct (appli Story Apps) : list_shops, shops_overview, shop_graphql',
           `Guides : ${GUIDE_TOPICS.join(', ')}`,
           '',
           `## Projets (${projects.length})`,
@@ -1221,14 +1223,29 @@ Read the file first (read_file) to get ids.`,
       inputSchema: { project: PROJECT },
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
     },
-    run(({ project }) => {
+    run(async ({ project }) => {
       const { store, catalog } = ctx.get();
       project = store.resolve(project);
       const result = exportTheme({ catalog, store, slug: project });
       if (!result.ok) return fail(`${result.message}\n${(result.errors || []).map((entry) => `${entry.file} :\n${entry.errors.map((error) => `  - ${error.path} : ${error.message}`).join('\n')}`).join('\n')}`);
       const notReady = /pas prêt à publier/.test(result.report);
       const migratedFiles = Object.keys(result.migrated || {});
-      return ok(`${migratedFiles.length ? `Projet mis à jour vers le thème ${catalog.version} : ${migratedFiles.map((file) => `${file} (${result.migrated[file].length})`).join(', ')} — réglages que le thème n'a plus, sans effet sur le rendu (undo possible).\n` : ''}${notReady ? '⚠️ Exporté, mais PAS PRÊT À PUBLIER : des points 🔴 restent (voir la revue ci-dessous). Importez-le sans le publier.\n' : ''}✅ Thème exporté : ${result.zip} (${result.size_mb} Mo, ${result.files} fichiers, personnalisés : ${result.overlays.join(', ') || 'aucun'})\nCheck-list : ${result.checklist}\n\n${result.report}`);
+
+      // Servi à distance (connecteur), le chemin du zip ne veut rien dire pour le marchand :
+      // le fichier est sur le serveur, pas chez lui. `publishExport` le dépose alors dans son
+      // espace et rend un lien de téléchargement, qui remplace le chemin dans la réponse.
+      let livraison = `${result.zip} (${result.size_mb} Mo, ${result.files} fichiers, personnalisés : ${result.overlays.join(', ') || 'aucun'})\nCheck-list : ${result.checklist}`;
+      if (typeof config.publishExport === 'function') {
+        try {
+          const lien = await config.publishExport({ zip: result.zip, checklist: result.checklist, project, catalog: catalog.version });
+          if (lien) livraison = `${lien} (${result.size_mb} Mo, ${result.files} fichiers, personnalisés : ${result.overlays.join(', ') || 'aucun'})`;
+        } catch (error) {
+          // L'export a réussi : un dépôt raté ne doit pas le transformer en échec.
+          livraison = `${result.zip} — ⚠️ mise en ligne du fichier impossible (${error.message})`;
+        }
+      }
+
+      return ok(`${migratedFiles.length ? `Projet mis à jour vers le thème ${catalog.version} : ${migratedFiles.map((file) => `${file} (${result.migrated[file].length})`).join(', ')} — réglages que le thème n'a plus, sans effet sur le rendu (undo possible).\n` : ''}${notReady ? '⚠️ Exporté, mais PAS PRÊT À PUBLIER : des points 🔴 restent (voir la revue ci-dessous). Importez-le sans le publier.\n' : ''}✅ Thème exporté : ${livraison}\n\n${result.report}`);
     }),
   );
 
@@ -1346,5 +1363,8 @@ Read the file first (read_file) to get ids.`,
     );
   }
 
+  // Boutiques du compte, via l'appli Shopify Story Apps (src/shops/).
+  registerShopTools(server, config);
+
   return server;
 }

package/src/version.js

@@ -1,3 +1,3 @@
 // Version du serveur MCP. Ici et dans package.json — les deux doivent être identiques
 // (npm test le vérifie), et rien d'autre ne la redéclare.
-export const VERSION = '1.0.0';
+export const VERSION = '1.1.0';