Récupère la liste des modes de livraison disponibles dans la boutique : retrait en magasin, livraison à domicile, transporteur, etc..

Instructions

Implementation Reference

• src/tools/data.ts:90-114 (handler)

  Handler function that resolves authentication, fetches delivery men data from '/workers/getLivreurs.php' via HTTP GET with shop credentials and format, logs the result, structures the data, and returns it. Handles errors gracefully.

  async ({ format }: CommonArgs, ctx: Ctx) => {
      try {
          const { shopId, apiKey } = resolveAuth(undefined, ctx);
          const data = await get(path, { idboutique: shopId, key: apiKey, format });
  
          process.stderr.write(
              `[caisse][tool:${toolName}] ok type=${Array.isArray(data) ? 'array' : typeof data}`
              + (Array.isArray(data) ? ` len=${data.length}` : '')
              + '\n'
          );
          //Array.isArray(data) ? data.slice(0, 50) : data
          const funcResult = structData( data);
          process.stderr.write(`[caisse][RES]  ${JSON.stringify(data)} \n`);
          process.stderr.write(`[caisse][RES] funcResult ${JSON.stringify(funcResult)} \n`);
          return funcResult;
          //return { content, structuredContent: isText ? undefined : data };
      } catch (e) {
          process.stderr.write(`[caisse][tool:${toolName}][error]\n`);
          process.stderr.write(`[caisse][tool:${toolName}][error] ${(e as Error).message}\n`);
          // renvoyer un message "propre" plutôt que laisser l’exception devenir un 424
          return {
              content: [{ type: 'text', text: `Erreur pendant la préparation de la réponse: ${(e as Error).message}` }],
              is_error: true,
          };
      }

• src/tools/data.ts:12-13 (schema)

  Shared input schema for list tools, including optional 'format' parameter (json, csv, html) defaulting to 'json'.

      format: z.enum(['json', 'csv', 'html']).default('json'),
  } satisfies Record<string, ZodTypeAny>;

• src/tools/data.ts:127-127 (registration)

  Registers the 'data_list_delivery_men' tool using the registerSimple helper, specifying the PHP endpoint '/workers/getLivreurs.php' and i18n titles/descriptions.

  registerSimple(server, 'data_list_delivery_men', '/workers/getLivreurs.php', t('tools.data_list_delivery_men.description'), t('tools.data_list_delivery_men.title'));

• src/tools/data.ts:52-73 (helper)

  Helper function to structure the tool response, creating a text preview (truncated if necessary) and structuredContent for MCP compatibility.

  function structData(data: any) {
      // on ne touche PAS à structuredContent (c’est ce que ChatGPT utilise)
      const light = Array.isArray(data)
          ? data.slice(0, 5000)//.map(({ id, nom, email, tel, ...r }) => ({ id, nom, email, tel }))
          : data;
  
      const maxLength = 40000;
      const preview =
          typeof light === 'string'
              ? (light.length > maxLength ? light.slice(0, maxLength) + '…(truncated)' : light)
              : safeStringify(light, 2, maxLength);   // <-- aperçu court et “safe”
      const wrapped =
          Array.isArray(data)
              ? { data: data }
              : data && typeof data === 'object'
                  ? data
                  : { data: data };
      return {
          content: [{ type: 'text', text: preview }],
          structuredContent: wrapped,
      };
  }

• src/tools/data.ts:75-117 (helper)

  Helper function that registers simple list tools on the MCP server, defining schema, handler, and annotations. Used for data_list_delivery_men and similar tools.

  function registerSimple(
      server: McpServer | any,
      toolName: string,
      path: string,
      title: string,
      entityLabel: string
  ) {
      server.registerTool(
          toolName,
          {
              title,
              description: `Liste des ${entityLabel}`,
              inputSchema: CommonShape, // ZodRawShape,
              annotations: { readOnlyHint: true }
          },
          async ({ format }: CommonArgs, ctx: Ctx) => {
              try {
                  const { shopId, apiKey } = resolveAuth(undefined, ctx);
                  const data = await get(path, { idboutique: shopId, key: apiKey, format });
  
                  process.stderr.write(
                      `[caisse][tool:${toolName}] ok type=${Array.isArray(data) ? 'array' : typeof data}`
                      + (Array.isArray(data) ? ` len=${data.length}` : '')
                      + '\n'
                  );
                  //Array.isArray(data) ? data.slice(0, 50) : data
                  const funcResult = structData( data);
                  process.stderr.write(`[caisse][RES]  ${JSON.stringify(data)} \n`);
                  process.stderr.write(`[caisse][RES] funcResult ${JSON.stringify(funcResult)} \n`);
                  return funcResult;
                  //return { content, structuredContent: isText ? undefined : data };
              } catch (e) {
                  process.stderr.write(`[caisse][tool:${toolName}][error]\n`);
                  process.stderr.write(`[caisse][tool:${toolName}][error] ${(e as Error).message}\n`);
                  // renvoyer un message "propre" plutôt que laisser l’exception devenir un 424
                  return {
                      content: [{ type: 'text', text: `Erreur pendant la préparation de la réponse: ${(e as Error).message}` }],
                      is_error: true,
                  };
              }
          }
      );
  }