@cyanheads/openfoodfacts-mcp-server 0.1.0

package/dist/mcp-server/tools/definitions/browse-taxonomy.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-taxonomy.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-taxonomy.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/compare-products.tool.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Tool definition for side-by-side nutrition comparison of multiple food products.
+ * @module mcp-server/tools/definitions/compare-products
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const offCompareProductsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    barcodes: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    products: z.ZodArray<z.ZodObject<{
+        barcode: z.ZodString;
+        product_name: z.ZodOptional<z.ZodString>;
+        brands: z.ZodOptional<z.ZodString>;
+        found: z.ZodBoolean;
+        nutriscore_grade: z.ZodOptional<z.ZodString>;
+        nova_group: z.ZodOptional<z.ZodNumber>;
+        ecoscore_grade: z.ZodOptional<z.ZodString>;
+        energy_kcal_100g: z.ZodOptional<z.ZodNumber>;
+        fat_100g: z.ZodOptional<z.ZodNumber>;
+        saturated_fat_100g: z.ZodOptional<z.ZodNumber>;
+        sugars_100g: z.ZodOptional<z.ZodNumber>;
+        salt_100g: z.ZodOptional<z.ZodNumber>;
+        proteins_100g: z.ZodOptional<z.ZodNumber>;
+        fiber_100g: z.ZodOptional<z.ZodNumber>;
+        completeness: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    succeeded: z.ZodNumber;
+    not_found: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "upstream_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Open Food Facts API returns 5xx or is unreachable for one or more barcodes";
+    readonly retryable: true;
+    readonly recovery: "Retry after a brief pause. Partial failures surface individual barcodes in not_found — verify those barcodes with off_get_product.";
+}], undefined>;
+//# sourceMappingURL=compare-products.tool.d.ts.map

package/dist/mcp-server/tools/definitions/compare-products.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-products.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/compare-products.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAsB,MAAM,+BAA+B,CAAC;AAkErF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0NjC,CAAC"}

package/dist/mcp-server/tools/definitions/compare-products.tool.js

@@ -0,0 +1,228 @@
+/**
+ * @fileoverview Tool definition for side-by-side nutrition comparison of multiple food products.
+ * @module mcp-server/tools/definitions/compare-products
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenFoodFactsService } from '../../../services/openfoodfacts/openfoodfacts-service.js';
+/** Fields needed for comparison — narrower than full product fetch. */
+const COMPARE_FIELDS = 'product_name,brands,nutriscore_grade,nova_group,ecoscore_grade,nutriments,completeness';
+/** Extract a numeric value from the raw nutriments map. */
+function n(raw, key) {
+    const v = raw[key];
+    return typeof v === 'number' ? v : undefined;
+}
+/** Build a comparison row from a raw product. */
+function buildCompareRow(barcode, raw) {
+    if (!raw)
+        return { barcode, found: false };
+    const row = { barcode, found: true };
+    if (raw.product_name)
+        row.product_name = raw.product_name;
+    if (raw.brands)
+        row.brands = raw.brands;
+    if (raw.nutriscore_grade)
+        row.nutriscore_grade = raw.nutriscore_grade;
+    if (typeof raw.nova_group === 'number')
+        row.nova_group = raw.nova_group;
+    if (raw.ecoscore_grade)
+        row.ecoscore_grade = raw.ecoscore_grade;
+    if (typeof raw.completeness === 'number')
+        row.completeness = raw.completeness;
+    if (raw.nutriments) {
+        const nm = raw.nutriments;
+        const energy = n(nm, 'energy-kcal_100g');
+        if (energy !== undefined)
+            row.energy_kcal_100g = energy;
+        const fat = n(nm, 'fat_100g');
+        if (fat !== undefined)
+            row.fat_100g = fat;
+        const satFat = n(nm, 'saturated-fat_100g');
+        if (satFat !== undefined)
+            row.saturated_fat_100g = satFat;
+        const sugars = n(nm, 'sugars_100g');
+        if (sugars !== undefined)
+            row.sugars_100g = sugars;
+        const salt = n(nm, 'salt_100g');
+        if (salt !== undefined)
+            row.salt_100g = salt;
+        const proteins = n(nm, 'proteins_100g');
+        if (proteins !== undefined)
+            row.proteins_100g = proteins;
+        const fiber = n(nm, 'fiber_100g');
+        if (fiber !== undefined)
+            row.fiber_100g = fiber;
+    }
+    return row;
+}
+export const offCompareProductsTool = tool('off_compare_products', {
+    title: 'Compare Food Products Side-by-Side',
+    description: 'Side-by-side nutrition and scoring comparison for 2–10 products by barcode. Fetches all products in parallel and returns a normalized table of energy (kcal/100g), fat, saturated fat, sugars, salt, protein, fiber, Nutri-Score, NOVA group, and Green-Score. Designed for "which of these cereals is healthiest?" or "compare these pasta brands" workflows. Missing nutrition data for any product is preserved as absent — comparisons are not imputed. Scores carry regional formula caveats. Data under ODbL 1.0 — cite Open Food Facts in downstream use.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        barcodes: z
+            .array(z
+            .string()
+            .regex(/^\d{8,14}$/)
+            .describe('EAN-13 or UPC barcode (8–14 digits).'))
+            .min(2)
+            .max(10)
+            .describe('2–10 barcodes to compare. All products are fetched in parallel. Example: ["3017620422003", "7622210100146"].'),
+    }),
+    output: z.object({
+        products: z
+            .array(z
+            .object({
+            barcode: z.string().describe('EAN-13 or UPC barcode (same as provided input).'),
+            product_name: z
+                .string()
+                .optional()
+                .describe('Product name. Absent when not yet entered by contributors.'),
+            brands: z
+                .string()
+                .optional()
+                .describe('Brand name(s), comma-separated. Absent when not yet entered.'),
+            found: z.boolean().describe('False if the barcode has no contributor record.'),
+            nutriscore_grade: z
+                .string()
+                .optional()
+                .describe('Nutri-Score letter (a–e). Absent when not computed.'),
+            nova_group: z
+                .number()
+                .optional()
+                .describe('NOVA processing class (1–4). Absent when not assigned.'),
+            ecoscore_grade: z
+                .string()
+                .optional()
+                .describe('Green-Score/Eco-Score (a–e or "unknown"). Often absent.'),
+            energy_kcal_100g: z
+                .number()
+                .optional()
+                .describe('Energy per 100g in kcal. Absent when not entered.'),
+            fat_100g: z
+                .number()
+                .optional()
+                .describe('Total fat per 100g in grams. Absent when not entered.'),
+            saturated_fat_100g: z
+                .number()
+                .optional()
+                .describe('Saturated fat per 100g in grams. Absent when not entered.'),
+            sugars_100g: z
+                .number()
+                .optional()
+                .describe('Total sugars per 100g in grams. Absent when not entered.'),
+            salt_100g: z
+                .number()
+                .optional()
+                .describe('Salt per 100g in grams. Absent when not entered.'),
+            proteins_100g: z
+                .number()
+                .optional()
+                .describe('Protein per 100g in grams. Absent when not entered.'),
+            fiber_100g: z
+                .number()
+                .optional()
+                .describe('Dietary fiber per 100g in grams. Often absent.'),
+            completeness: z
+                .number()
+                .optional()
+                .describe('Data completeness 0–1. Low values mean many fields are missing.'),
+        })
+            .describe('A single product comparison row.'))
+            .describe('Comparison rows, one per barcode in input order.'),
+        succeeded: z.number().describe('Number of barcodes that resolved to a found product.'),
+        not_found: z
+            .array(z.string().describe('EAN-13 or UPC barcode with no contributor record.'))
+            .describe('Barcodes with no contributor record. Not an error — the product may exist but not yet entered in Open Food Facts.'),
+    }),
+    errors: [
+        {
+            reason: 'upstream_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'Open Food Facts API returns 5xx or is unreachable for one or more barcodes',
+            retryable: true,
+            recovery: 'Retry after a brief pause. Partial failures surface individual barcodes in not_found — verify those barcodes with off_get_product.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getOpenFoodFactsService();
+        // Fetch all products in parallel
+        const settlements = await Promise.allSettled(input.barcodes.map((barcode) => svc.getProductFields(barcode, COMPARE_FIELDS, ctx)));
+        const products = [];
+        const not_found = [];
+        let succeeded = 0;
+        for (let i = 0; i < input.barcodes.length; i++) {
+            const barcode = input.barcodes[i];
+            const result = settlements[i];
+            if (result === undefined || result.status === 'rejected') {
+                // If it was an explicit service error (not just not-found), propagate it
+                if (result?.status === 'rejected') {
+                    const err = result.reason;
+                    // If it looks like an upstream error, throw it
+                    if (err.message?.includes('Open Food Facts')) {
+                        throw serviceUnavailable(`Failed to fetch barcode ${barcode}: ${err.message}`, { barcode }, { cause: err });
+                    }
+                }
+                products.push({ barcode, found: false });
+                not_found.push(barcode);
+                continue;
+            }
+            const raw = result.value;
+            if (!raw) {
+                products.push({ barcode, found: false });
+                not_found.push(barcode);
+            }
+            else {
+                products.push(buildCompareRow(barcode, raw));
+                succeeded++;
+            }
+        }
+        ctx.log.info('Product comparison completed', {
+            total: input.barcodes.length,
+            succeeded,
+            not_found: not_found.length,
+        });
+        return { products, succeeded, not_found };
+    },
+    format: (result) => {
+        const lines = [
+            `## Product Comparison (${result.succeeded}/${result.products.length} found)\n`,
+        ];
+        if (result.not_found.length > 0) {
+            lines.push(`**Not found:** ${result.not_found.join(', ')} (not yet entered in Open Food Facts)\n`);
+        }
+        const found = result.products.filter((p) => p.found);
+        if (found.length === 0) {
+            lines.push('No products found. Try off_get_product on individual barcodes to verify.');
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        // Scores table — includes all products with found status
+        lines.push('### Scores');
+        lines.push('| Product | Barcode | Found | Nutri-Score | NOVA | Eco-Score | Completeness |');
+        lines.push('|:--------|:--------|:------|:------------|:-----|:----------|:-------------|');
+        for (const p of result.products) {
+            const name = p.product_name
+                ? `${p.product_name}${p.brands ? ` (${p.brands})` : ''}`
+                : `Barcode ${p.barcode}`;
+            const completeness = p.completeness !== undefined ? `${Math.round(p.completeness * 100)}%` : 'N/A';
+            lines.push(`| ${name} | ${p.barcode} | ${p.found} | ${p.nutriscore_grade ?? 'N/A'} | ${p.nova_group ?? 'N/A'} | ${p.ecoscore_grade ?? 'N/A'} | ${completeness} |`);
+        }
+        // Nutrition table
+        lines.push('\n### Nutrition per 100g');
+        lines.push('| Product | Energy (kcal) | Fat (g) | Sat. Fat (g) | Sugars (g) | Salt (g) | Protein (g) | Fiber (g) |');
+        lines.push('|:--------|:-------------|:--------|:-------------|:-----------|:---------|:------------|:----------|');
+        for (const p of found) {
+            const name = p.product_name ?? `Barcode ${p.barcode}`;
+            const fmt = (v) => (v !== undefined ? String(v) : 'N/A');
+            lines.push(`| ${name} | ${fmt(p.energy_kcal_100g)} | ${fmt(p.fat_100g)} | ${fmt(p.saturated_fat_100g)} | ${fmt(p.sugars_100g)} | ${fmt(p.salt_100g)} | ${fmt(p.proteins_100g)} | ${fmt(p.fiber_100g)} |`);
+        }
+        // Completeness notices
+        const lowCompleteness = found.filter((p) => p.completeness !== undefined && p.completeness < 0.5);
+        if (lowCompleteness.length > 0) {
+            lines.push(`\n*Low completeness (< 50%): ${lowCompleteness.map((p) => p.product_name ?? p.barcode).join(', ')} — many fields may be missing.*`);
+        }
+        lines.push('\n*Data: Open Food Facts (ODbL 1.0) — crowd-sourced. "N/A" = not yet entered.*');
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=compare-products.tool.js.map

package/dist/mcp-server/tools/definitions/compare-products.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-products.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/compare-products.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-product.tool.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Tool definition for fetching a food product by barcode from Open Food Facts.
+ * @module mcp-server/tools/definitions/get-product
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const offGetProductTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    barcode: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        categories_tags: "categories_tags";
+        labels_tags: "labels_tags";
+        product_name: "product_name";
+        brands: "brands";
+        quantity: "quantity";
+        ingredients_text: "ingredients_text";
+        ingredients: "ingredients";
+        allergens_tags: "allergens_tags";
+        additives_tags: "additives_tags";
+        nutriscore_grade: "nutriscore_grade";
+        nova_group: "nova_group";
+        ecoscore_grade: "ecoscore_grade";
+        nutriments: "nutriments";
+        packaging_tags: "packaging_tags";
+        origins_tags: "origins_tags";
+        image_url: "image_url";
+        completeness: "completeness";
+        data_quality_tags: "data_quality_tags";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    barcode: z.ZodString;
+    found: z.ZodBoolean;
+    product: z.ZodOptional<z.ZodObject<{
+        product_name: z.ZodOptional<z.ZodString>;
+        brands: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodOptional<z.ZodString>;
+        ingredients_text: z.ZodOptional<z.ZodString>;
+        ingredients: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+            percent_estimate: z.ZodOptional<z.ZodNumber>;
+            vegan: z.ZodOptional<z.ZodString>;
+            vegetarian: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        allergens_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        additives_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        nutriscore_grade: z.ZodOptional<z.ZodString>;
+        nova_group: z.ZodOptional<z.ZodNumber>;
+        ecoscore_grade: z.ZodOptional<z.ZodString>;
+        nutriments: z.ZodOptional<z.ZodObject<{
+            energy_kcal_100g: z.ZodOptional<z.ZodNumber>;
+            fat_100g: z.ZodOptional<z.ZodNumber>;
+            saturated_fat_100g: z.ZodOptional<z.ZodNumber>;
+            carbohydrates_100g: z.ZodOptional<z.ZodNumber>;
+            sugars_100g: z.ZodOptional<z.ZodNumber>;
+            fiber_100g: z.ZodOptional<z.ZodNumber>;
+            proteins_100g: z.ZodOptional<z.ZodNumber>;
+            salt_100g: z.ZodOptional<z.ZodNumber>;
+            sodium_100g: z.ZodOptional<z.ZodNumber>;
+            energy_kcal_serving: z.ZodOptional<z.ZodNumber>;
+            fat_serving: z.ZodOptional<z.ZodNumber>;
+            sugars_serving: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        categories_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        labels_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        packaging_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        origins_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        image_url: z.ZodOptional<z.ZodString>;
+        completeness: z.ZodOptional<z.ZodNumber>;
+        data_quality_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Barcode status:0 — not present in any contributor record";
+    readonly recovery: "Try off_search_products with the product name or brand to find the correct barcode, or check that the barcode digits are correct.";
+}, {
+    readonly reason: "upstream_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Open Food Facts API returns 5xx or is unreachable";
+    readonly retryable: true;
+    readonly recovery: "Retry after a brief pause. If persistent, the Open Food Facts service may be experiencing high load.";
+}], undefined>;
+//# sourceMappingURL=get-product.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-product.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-product.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-product.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAqDjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0W5B,CAAC"}