Openfoodfacts MCP

🚀 Open Food Facts Multi-Purpose Console (MCP)

The Open Food Facts Multi-Purpose Console (MCP) offers an integrated solution for handling various food data-related tasks, supporting the development, data analysis, and user interaction of the Open Food Facts project.

🚀 Quick Start

Prerequisites

• Operating Systems: Linux, macOS, and Windows (WSL2) are supported.
• Node.js Version: v14.0 or higher.

Installation

npm install mcp --save-dev

Running the Console

• Standard Mode:

npx mcp

• Developer Mode:

npx mcp --developer

✨ Features

Product Search and Barcode Query

• Principle: Interact with the Open Food Facts database via the REST API.
• Code Example:

const search = require('mcp').productSearch;
search('Nutella', (err, result) => {
  if (err) return console.error(err);
  console.log(result.items);
});

Nutritional Analysis Tool

• AI-Powered: Combine natural language processing and machine learning models for intelligent data parsing.
• Features:
  • Extract nutritional components.
  • Generate health scores.
  • Provide conditional suggestions.

Developer Mode

• Toolset Expansion:
  • GitHub Issue Analysis: Offer advanced features for the developer mode.
  • Enhanced Contribution Guidelines: Support code review and quality inspection.
• Runtime Configuration:
  • --developer: Enable the developer mode and load additional toolsets.
  • --port/--host: Customize the server address and port.

🔧 Technical Details

Project Architecture

src/
├── cli.ts                # Command-line interface parsing
├── server.ts            # Core service implementation
├── tools/
│   ├── index.ts         # Tool registration center
│   ├── product-search.ts # Product search tool
│   └── ai-analysis-tool.ts # AI analysis module
└── resources/          # Resource handling components

📄 License

This project is licensed under the AGPL-3.0 open-source license, consistent with Open Food Facts.