caisse-enregistreuse-mcp-server

Instructions

Implementation Reference

• src/tools/data.ts:162-168 (handler)

  The handler function that implements the core logic of the 'order_detail' tool. It resolves shop authentication, makes an HTTP GET request to the PHP backend endpoint '/workers/getOrder.php' with the order_id, and returns the structured response using the shared structData helper.

  async ({ order_id }: getOrderArgs, ctx: Ctx) => {
      const { shopId, apiKey } = resolveAuth(undefined, ctx);
      const data = await get('/workers/getOrder.php', { idboutique: shopId, key: apiKey, order_id });
  
      return structData(data);
      //return { content, structuredContent: isText ? undefined : data };
  }

• src/tools/data.ts:15-17 (schema)

  Zod input schema shape for the 'order_detail' tool, defining the required 'order_id' parameter as an integer.

  const getOrderShape = {
      order_id: z.number().int(),
  } satisfies Record<string, ZodTypeAny>;

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

  The server.registerTool call that registers the 'order_detail' tool, including metadata (title, description from i18n), input schema reference, read-only annotation, and inline handler function.

  server.registerTool(
      'order_detail',
      {
          title: t('tools.order_detail.title'),
          description: t('tools.order_detail.description'),
          inputSchema: getOrderShape, // ZodRawShape,
          annotations: { readOnlyHint: true }
      },
      async ({ order_id }: getOrderArgs, ctx: Ctx) => {
          const { shopId, apiKey } = resolveAuth(undefined, ctx);
          const data = await get('/workers/getOrder.php', { idboutique: shopId, key: apiKey, order_id });
  
          return structData(data);
          //return { content, structuredContent: isText ? undefined : data };
      }
  );

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

  TypeScript type definition for the input arguments of the order_detail handler, inferred from the Zod schema.

  type getOrderArgs = InferFromShape<typeof getOrderShape>;

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

  Shared helper function used by order_detail (and other data tools) to format arbitrary data into MCP-standard response with text preview and structured content, handling truncation and serialization safely.

  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,
      };
  }