caisse-enregistreuse-mcp-server

Instructions

Implementation Reference

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

  The handler function registered for the 'data_list_discounts' tool (shared via registerSimple). It resolves authentication, performs an HTTP GET to '/workers/getDiscounts.php' with shop credentials and format, structures the data response, and handles errors.

      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)

  Common input schema used for 'data_list_discounts' tool, defining the optional 'format' parameter.

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

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

  Registration of the 'data_list_discounts' tool using the generic registerSimple helper, specifying the PHP endpoint and i18n labels.

  registerSimple(server, 'data_list_discounts', '/workers/getDiscounts.php', t('tools.data_list_discounts.description'), t('tools.data_list_discounts.title'));

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

  The registerSimple helper function that defines the generic handler, schema, and registration logic used for 'data_list_discounts' and other list 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,
                  };
              }
          }
      );
  }