🍎 Open Food Facts MCP Server

Bringing the world's largest open food database to your AI assistant

A sleek Model Context Protocol server that bridges AI systems with Open Food Facts' comprehensive database of 3M+ products. Get instant access to ingredients, nutrition facts, allergens, and sustainability scores.

---

✨ What's Inside

🔍 Smart Product Search - Find anything from "organic pasta" to specific brands
📱 Barcode Magic - Instant product details from any barcode scan
🥗 Nutrition Intelligence - Filter by protein, sugar, calories, you name it
🏷️ Category Explorer - Browse beverages, snacks, dairy, and 1000+ categories
🌍 Global Ready - Multi-language support for worldwide products
⚡ Lightning Fast - Smart caching keeps responses snappy
🛡️ Rock Solid - Full TypeScript with bulletproof validation

---

🚀 Quick Start

# Get everything ready
npm install && npm run build

# Fire it up
npm start

🔧 MCP Integration

Drop this into your MCP configuration and you're golden:

{
  "mcpServers": {
    "calormeal": {
      "command": "node",
      "args": ["./dist/index.js"]
    }
  }
}

---

🛠️ The Toolkit

search_products

The Swiss Army knife of food search

{
  "query": "dark chocolate 70%",
  "lang": "en",
  "sort_by": "popularity"
}

get_product

Barcode to full product intel in milliseconds

{
  "barcode": "3017620422003"
}

search_by_nutrition

Your personal nutrition detective

{
  "nutrient": "proteins",
  "min_value": 20,
  "max_value": 30
}

search_by_category

Explore entire food universes

{
  "category": "plant-based-foods"
}

---

📊 What You Get Back

Every response comes with verified data and clear source attribution:

{
  code: "3017620422003",
  product_name: "Nutella",
  brands: "Ferrero",
  nutrition_grades: "e",
  ecoscore_grade: "d",
  nutriments: {
    "energy-kcal_100g": 539,
    "proteins_100g": 6.3,
    "sugars_100g": 56.3
  },
  source: "openfoodfacts"
}

🏗️ Under the Hood

Clean Architecture → MCP protocol cleanly separated from API logic
Performance First → 5-minute intelligent caching layer
Type Safety → Full TypeScript + Zod schema validation
Error Resilience → Helpful error messages with fix suggestions
Modern Stack → ES modules, async/await, functional patterns

---

🔥 Development Mode

npm run dev     # Hot reload development
npm run build   # Production build  
npm start       # Launch the server

---

🤝 Contributing

Built with ❤️ for the open food community. Issues and PRs welcome!

Powered by Open Food Facts - The Wikipedia of food

---

MIT Licensed • Node.js 18+ • TypeScript Ready