English Français العربية

Open Food Facts

السجل الرسمي البيانات وقواعدها

Search and contribute to the Open Food Facts database.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package openfoodfacts-mcp
Claude Code 
claude mcp add open-food-facts -e 'OFF_USER_AGENT=<OFF_USER_AGENT>' -e 'OFF_USER_ID=<OFF_USER_ID>' -e 'OFF_PASSWORD=<your off_password>' -e 'OFF_COUNTRY=<OFF_COUNTRY>' -- npx -y openfoodfacts-mcp@2.6.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "open-food-facts": {
            "command": "npx",
            "args": [
                "-y",
                "openfoodfacts-mcp@2.6.0"
            ],
            "env": {
                "OFF_USER_AGENT": "<OFF_USER_AGENT>",
                "OFF_USER_ID": "<OFF_USER_ID>",
                "OFF_PASSWORD": "<your off_password>",
                "OFF_COUNTRY": "<OFF_COUNTRY>"
            }
        }
    }
}

متغيرات البيئة

  • OFF_USER_AGENT إلزامي User-Agent string in format 'AppName/Version (email)'. Required by the Open Food Facts API.
  • OFF_USER_ID Open Food Facts user ID (optional, needed for write operations).
  • OFF_PASSWORD سري Open Food Facts password (optional, needed for write operations).
  • OFF_COUNTRY Country subdomain (default: 'world').
NPM package openfoodfacts-mcp
Claude Code 
claude mcp add open-food-facts -e 'MCP_TRANSPORT=<MCP_TRANSPORT>' -e 'OFF_USER_AGENT=<OFF_USER_AGENT>' -e 'OFF_USER_ID=<OFF_USER_ID>' -e 'OFF_PASSWORD=<your off_password>' -e 'OFF_COUNTRY=<OFF_COUNTRY>' -- npx -y openfoodfacts-mcp@2.6.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "open-food-facts": {
            "command": "npx",
            "args": [
                "-y",
                "openfoodfacts-mcp@2.6.0"
            ],
            "env": {
                "MCP_TRANSPORT": "<MCP_TRANSPORT>",
                "OFF_USER_AGENT": "<OFF_USER_AGENT>",
                "OFF_USER_ID": "<OFF_USER_ID>",
                "OFF_PASSWORD": "<your off_password>",
                "OFF_COUNTRY": "<OFF_COUNTRY>"
            }
        }
    }
}

متغيرات البيئة

  • MCP_TRANSPORT إلزامي Transport type.
  • OFF_USER_AGENT إلزامي User-Agent string in format 'AppName/Version (email)'. Required by the Open Food Facts API.
  • OFF_USER_ID Open Food Facts user ID (optional, needed for write operations).
  • OFF_PASSWORD سري Open Food Facts password (optional, needed for write operations).
  • OFF_COUNTRY Country subdomain (default: 'world').

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. openfoodfacts-mcp
  2. Use Cases
  3. Setup
  4. Environment Variables
  5. Tools
  6. Contributing
  7. Releases

openfoodfacts-mcp

MCP server for the Open Food Facts API - search, read, and contribute to the world's largest open food database.

Use Cases

Look up a product by name: "How many calories in a Sainsbury's buffalo chicken wrap?" -> searches by name, finds the product, and returns nutrition data.

Look up a product by barcode: "What's in this product with barcode 3017620422003?" -> fetches Nutella's ingredients, Nutri-Score, and nutrition data.

Find healthy options: "Search for breakfast cereals with Nutri-Score A" -> searches with category and nutrition grade filters.

Contribute data: "Add the product name and brand for barcode 12345678" -> creates or updates a product entry on Open Food Facts.

Explore the database: "What brands of organic chocolate are in the database?" -> uses autocomplete and search to explore.

Setup

Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Set OFF_USER_AGENT to identify your app (e.g. openfoodfacts-mcp/1.2.0 (you@example.com)). For write operations (adding/editing products, uploading images), also set OFF_USER_ID and OFF_PASSWORD.

Environment Variables

VariableRequiredDescription
OFF_USER_AGENTYesUser-Agent string, e.g. "AppName/1.0 (email@example.com)"
OFF_USER_IDNoOpen Food Facts username (for write operations)
OFF_PASSWORDNoOpen Food Facts password (for write operations)
OFF_COUNTRYNoCountry subdomain (default: world)

Tools

ToolDescriptionAuth
get_productGet product info by barcodeNo
search_products_standardSearch with structured filters (brand, category, Nutri-Score)No
search_products_luceneSearch with Lucene syntax, negation, and boolean logicNo
autocompleteAutocomplete brands, categories, labels, etc.No
add_or_edit_productAdd or update a productYes
upload_imageUpload a product imageYes
select_imageSelect, crop, and rotate an imageYes
call_apiCall any OFF API endpoint directlyDepends
get_api_docsGet OFF API documentationNo

Contributing

Pull requests are welcomed on GitHub! To get started:

  1. Install Git and Node.js
  2. Clone the repository
  3. Install dependencies with npm install
  4. Run npm run test to run tests
  5. Build with npm run build

Releases

Versions follow the semantic versioning spec.

To release:

  1. Use npm version <major | minor | patch> to bump the version
  2. Run git push --follow-tags to push with tags
  3. Wait for GitHub Actions to publish to the NPM registry.

الأسئلة الشائعة

ما هو Open Food Facts؟

Search and contribute to the Open Food Facts database.

كيف أثبّت Open Food Facts؟

يعمل على جهازك. في Claude Code: claude mcp add open-food-facts -e 'OFF_USER_AGENT=<OFF_USER_AGENT>' -e 'OFF_USER_ID=<OFF_USER_ID>' -e 'OFF_PASSWORD=<your off_password>' -e 'OFF_COUNTRY=<OFF_COUNTRY>' -- npx -y openfoodfacts-mcp@2.6.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Open Food Facts إلى مفتاح API؟

نعم. يتطلب OFF_USER_AGENT, OFF_PASSWORD, MCP_TRANSPORT، وتضبطها في إعداداته.

هل Open Food Facts مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Open Food Facts؟

ينشره domdomegg. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.