Openfoodfacts MCP

🚀 開放食品事實多用途控制檯 (MCP)

MCP旨在為Open Food Facts項目的開發、數據分析和用戶交互提供支持，是一個集成化解決方案，可處理各類與食品數據相關的任務。

🚀 快速開始

MCP支持在Linux、macOS及Windows（WSL2）系統上運行，且需要Node.js v14.0或更高版本。按照以下步驟進行安裝和運行：

1. 安裝：在項目中執行以下命令進行安裝：

npm install mcp --save-dev

2. 運行：
   • 標準模式：使用以下命令啟動：

npx mcp

- **開發者模式**：使用以下命令啟用開發者模式：

npx mcp --developer

✨ 主要特性

• 產品搜索：支持通過名稱或條形碼查找食品信息。
• 營養分析：提供基於AI的產品健康評估工具。
• GitHub問題管理：針對開發者模式，提供問題跟蹤和協作支持。

📦 安裝指南

環境要求

• 操作系統：支持Linux、macOS及Windows（WSL2）。
• Node.js版本：v14.0或更高版本。

安裝步驟

使用以下命令將MCP安裝到項目中：

npm install mcp --save-dev

💻 使用示例

基礎用法

以下是使用MCP進行產品搜索的示例代碼：

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

📚 詳細文檔

核心功能模塊

產品搜索與條形碼查詢

• 實現原理：利用Open Food Facts數據庫，通過REST API進行交互。
• 代碼示例：

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

營養分析工具

• AI驅動：結合自然語言處理和機器學習模型，提供智能數據解析。
• 功能特點：
  • 營養成分提取
  • 健康評分生成
  • 條件建議提供

開發者模式

工具集擴展

• 新增工具：
  • GitHub問題分析：提供針對開發者模式的高級功能。
  • 貢獻指南增強：支持代碼審查和質量檢測。

運行時配置

• 命令行參數：
  • --developer：啟用開發者模式，加載額外工具集。
  • --port/--host：自定義服務器地址和端口。

🔧 技術細節

項目架構

src/
├── cli.ts                # 命令行接口解析
├── server.ts            # 核心服務實現
├── tools/
│   ├── index.ts         # 工具註冊中心
│   ├── product-search.ts # 產品搜索工具
│   └── ai-analysis-tool.ts # AI分析模塊
└── resources/          # 資源處理組件

📄 許可證

本項目遵循AGPL - 3.0開源協議，與Open Food Facts保持一致的許可方式。