@unclick/openfoodfacts-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+Apache License 2.0
+
+Copyright (c) 2026 UnClick / malamutemayhem
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,35 @@
+# Open Food Facts MCP by UnClick
+
+Search food products, ingredients, nutrition, brands, and categories. No API key.
+
+> By UnClick. 180+ tools plus persistent agent memory in one install: https://unclick.world
+
+## Install
+
+Installs straight from GitHub, no npm account needed.
+
+```json
+{
+  "mcpServers": {
+    "openfoodfacts": {
+      "command": "npx",
+      "args": ["-y", "https://github.com/malamutemayhem/unclick/releases/download/standalone-mcps-latest/openfoodfacts.tgz"]
+    }
+  }
+}
+```
+
+## Tools
+
+- `food_search`
+- `food_get_product`
+- `food_by_category`
+
+## Want the rest?
+
+This is one connector. [UnClick](https://unclick.world) bundles 180+ tools plus
+persistent cross-session agent memory in a single install.
+
+## License
+
+Apache-2.0

package/dist/index.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+// Open Food Facts MCP. Standalone MCP server by UnClick.
+// By UnClick. 180+ tools plus persistent agent memory in one install: https://unclick.world
+//
+// Generated from the UnClick connector by scripts/generate-standalone-mcp.mjs.
+// Edit the connector in the UnClick monorepo, not here.
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { searchFoodProducts, getFoodProduct, getFoodByCategory, } from "./openfoodfacts-tool.js";
+const TOOLS = [
+    {
+        name: "food_search",
+        description: "Search for food products on Open Food Facts.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                query: { type: "string" },
+                page: { type: "number" },
+                page_size: { type: "number" },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "food_get_product",
+        description: "Get a food product from Open Food Facts by barcode.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                barcode: { type: "string" },
+            },
+            required: ["barcode"],
+        },
+    },
+    {
+        name: "food_by_category",
+        description: "Get food products by category from Open Food Facts.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                category: { type: "string" },
+                page: { type: "number" },
+            },
+            required: ["category"],
+        },
+    }
+];
+const HANDLERS = {
+    food_search: (args) => searchFoodProducts(args),
+    food_get_product: (args) => getFoodProduct(args),
+    food_by_category: (args) => getFoodByCategory(args),
+};
+const server = new Server({ name: "io.github.malamutemayhem/openfoodfacts", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const handler = HANDLERS[req.params.name];
+    if (!handler) {
+        return { content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }], isError: true };
+    }
+    try {
+        const result = await handler((req.params.arguments ?? {}));
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: message }], isError: true };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[openfoodfacts-mcp] fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/openfoodfacts-tool.js

@@ -0,0 +1,105 @@
+// ─── Open Food Facts Product Database ────────────────────────────────────────
+// Free, open-source food product database - no auth required.
+// Docs: https://wiki.openfoodfacts.org/API
+const OFF_BASE = "https://world.openfoodfacts.org";
+// ─── API helper ──────────────────────────────────────────────────────────────
+async function offFetch(url) {
+    const res = await fetch(url, {
+        headers: { "User-Agent": "UnClick-MCP/1.0 (mcp@unclick.io)" },
+    });
+    if (!res.ok) {
+        throw new Error(`Open Food Facts API HTTP ${res.status}: ${url}`);
+    }
+    return res.json();
+}
+function mapProduct(p) {
+    return {
+        code: p.code ?? p._id,
+        product_name: p.product_name ?? p.product_name_en ?? null,
+        brands: p.brands ?? null,
+        categories: p.categories ?? null,
+        quantity: p.quantity ?? null,
+        image_url: p.image_url ?? null,
+        nutriscore_grade: p.nutriscore_grade ?? null,
+        ecoscore_grade: p.ecoscore_grade ?? null,
+        nova_group: p.nova_group ?? null,
+        ingredients_text: p.ingredients_text ?? null,
+        allergens: p.allergens ?? null,
+        labels: p.labels ?? null,
+        countries: p.countries ?? null,
+        nutriments: p.nutriments
+            ? {
+                energy_kcal_100g: p.nutriments["energy-kcal_100g"] ?? null,
+                fat_100g: p.nutriments["fat_100g"] ?? null,
+                saturated_fat_100g: p.nutriments["saturated-fat_100g"] ?? null,
+                carbohydrates_100g: p.nutriments["carbohydrates_100g"] ?? null,
+                sugars_100g: p.nutriments["sugars_100g"] ?? null,
+                fiber_100g: p.nutriments["fiber_100g"] ?? null,
+                proteins_100g: p.nutriments["proteins_100g"] ?? null,
+                salt_100g: p.nutriments["salt_100g"] ?? null,
+            }
+            : null,
+    };
+}
+// ─── Operations ──────────────────────────────────────────────────────────────
+export async function searchFoodProducts(args) {
+    const query = String(args.query ?? args.search_terms ?? "").trim();
+    if (!query)
+        throw new Error("query is required.");
+    const page = Math.max(1, Number(args.page ?? 1));
+    const pageSize = Math.min(50, Math.max(1, Number(args.page_size ?? 10)));
+    const url = new URL(`${OFF_BASE}/cgi/search.pl`);
+    url.searchParams.set("search_terms", query);
+    url.searchParams.set("json", "1");
+    url.searchParams.set("page", String(page));
+    url.searchParams.set("page_size", String(pageSize));
+    url.searchParams.set("fields", "code,product_name,brands,categories,quantity,image_url,nutriscore_grade,ecoscore_grade,nova_group,nutriments");
+    const data = await offFetch(url.toString());
+    return {
+        query,
+        count: data.count,
+        page,
+        page_size: pageSize,
+        products: (data.products ?? []).map(mapProduct),
+    };
+}
+export async function getFoodProduct(args) {
+    const barcode = String(args.barcode ?? "").trim().replace(/[^0-9]/g, "");
+    if (!barcode)
+        throw new Error("barcode is required (numeric EAN/UPC code).");
+    const data = await offFetch(`${OFF_BASE}/api/v2/product/${barcode}.json`);
+    if (data.status !== 1 || !data.product) {
+        return { error: `Product with barcode ${barcode} not found.` };
+    }
+    return mapProduct({ ...data.product, code: barcode });
+}
+export async function getFoodByCategory(args) {
+    const category = String(args.category ?? "").trim().toLowerCase().replace(/\s+/g, "-");
+    if (!category)
+        throw new Error("category is required (e.g. 'biscuits', 'dairy').");
+    const page = Math.max(1, Number(args.page ?? 1));
+    const pageSize = Math.min(50, Math.max(1, Number(args.page_size ?? 10)));
+    const url = new URL(`${OFF_BASE}/category/${category}.json`);
+    url.searchParams.set("page", String(page));
+    url.searchParams.set("page_size", String(pageSize));
+    const data = await offFetch(url.toString());
+    return {
+        category,
+        count: data.count ?? 0,
+        page,
+        products: (data.products ?? []).slice(0, pageSize).map(mapProduct),
+    };
+}
+// ─── Public dispatcher ────────────────────────────────────────────────────────
+export async function openFoodFactsAction(action, args) {
+    switch (action) {
+        case "search_food_products": return searchFoodProducts(args);
+        case "get_food_product": return getFoodProduct(args);
+        case "get_food_by_category": return getFoodByCategory(args);
+        default:
+            return {
+                error: `Unknown Open Food Facts action: "${action}". ` +
+                    "Valid: search_food_products, get_food_product, get_food_by_category.",
+            };
+    }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@unclick/openfoodfacts-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.malamutemayhem/openfoodfacts",
+  "description": "Search food products, ingredients, nutrition, brands, and categories. No API key. By UnClick (https://unclick.world).",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "unclick",
+    "food",
+    "nutrition",
+    "open-food-facts"
+  ],
+  "author": "UnClick (https://unclick.world)",
+  "type": "module",
+  "bin": {
+    "openfoodfacts-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.15.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/malamutemayhem/unclick.git",
+    "directory": "packages/standalone/openfoodfacts-mcp"
+  },
+  "homepage": "https://unclick.world"
+}

package/server.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.malamutemayhem/openfoodfacts",
+  "title": "Open Food Facts MCP by UnClick",
+  "description": "Search food products, ingredients, nutrition, brands, and categories. No API key. By UnClick.",
+  "version": "0.1.0",
+  "websiteUrl": "https://unclick.world",
+  "icons": [
+    {
+      "src": "https://unclick.world/favicon.png",
+      "mimeType": "image/png",
+      "sizes": [
+        "512x512"
+      ]
+    }
+  ],
+  "repository": {
+    "url": "https://github.com/malamutemayhem/unclick.git",
+    "source": "github",
+    "subfolder": "packages/standalone/openfoodfacts-mcp"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@unclick/openfoodfacts-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}