Open Food Facts MCP

🚀 オープンフードファクツMCPサーバー

このサーバーは、AIアシスタントにオープンフードファクツデータベースへのアクセスを提供する包括的なモデルコンテキストプロトコル（MCP）サーバーです。詳細な食品情報、栄養データ、環境スコアをクエリし、ユーザーが適切な食品選択を行えるよう支援します。

🚀 クイックスタート

Dockerデプロイ（推奨）

# クローンして実行
git clone https://github.com/conner/open-food-facts-mcp
cd open-food-facts-mcp
docker-compose up --build

ローカル開発

# 依存関係のインストール
npm install

# 環境の設定
cp .env.example .env

# ビルドと起動
npm run build
npm start

# 開発モード
npm run dev

✨ 主な機能

• 商品検索：バーコードで詳細情報（栄養成分、原材料、スコアなど）を取得
• スマート検索：カテゴリ、ブランド、栄養グレードなどの高度なフィルタリングで商品を検索
• 栄養分析：ヌトリスコア、NOVAグループ、エコスコアの評価を解釈
• 商品比較：複数の商品をさまざまな基準で並べて比較
• 食事推奨：食事の好みや制限に基づいた商品提案を取得
• レート制限：オープンフードファクツAPIの制約を尊重する組み込みのレート制限
• Docker対応：DockerとDocker Composeを使用した本番環境デプロイ

📦 インストール

サーバーは環境変数を介して設定できます。

# API設定
OPEN_FOOD_FACTS_BASE_URL=https://world.openfoodfacts.net
OPEN_FOOD_FACTS_USER_AGENT=YourApp/1.0 (contact@example.com)

# レート制限（1分あたりのリクエスト数）
RATE_LIMIT_PRODUCTS=100
RATE_LIMIT_SEARCH=10
RATE_LIMIT_FACETS=2

💻 使用例

get_product

バーコードで包括的な商品情報を取得します。

{
  "barcode": "3017620422003"
}

返り値：商品名、ブランド、栄養スコア、原材料、栄養成分、メタデータ

search_products

高度なフィルタリング機能で商品を検索します。

{
  "search": "organic chocolate",
  "categories": "snacks",
  "nutrition_grades": "a,b,c",
  "page_size": 10
}

フィルター：カテゴリ、ブランド、国、栄養グレード、NOVAグループ、ソートオプション

analyze_product

詳細な栄養分析とスコアの解釈を取得します。

{
  "barcode": "3017620422003"
}

返り値：スコアの説明、健康評価付きの栄養成分内訳、加工レベルの詳細

compare_products

複数の商品をさまざまな側面で比較します。

{
  "barcodes": ["3017620422003", "8712566073219"],
  "focus": "nutrition"
}

焦点オプション：nutrition、environmental、processing、ingredients

get_product_suggestions

パーソナライズされた商品推奨を取得します。

{
  "category": "beverages",
  "dietary_preferences": ["vegan", "organic"],
  "min_nutriscore": "b",
  "max_results": 5
}

食事オプション：vegan、vegetarian、gluten-free、organic、low-fat、low-sugar、high-protein

📚 ドキュメント

MCP統合

MCPクライアントの設定に追加します。

{
  "mcpServers": {
    "open-food-facts": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "open-food-facts-mcp"]
    }
  }
}

またはローカル開発用：

{
  "mcpServers": {
    "open-food-facts": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/open-food-facts-mcp"
    }
  }
}

データとスコア

ヌトリスコア

• A - Eの評価：全体的な栄養品質を示す
• 緑（A/B）：健康的な選択
• 赤（D/E）：あまり健康的でない選択

NOVAグループ

• グループ1：未加工/最小限に加工された食品
• グループ2：加工された調理用材料
• グループ3：加工食品
• グループ4：超加工食品

エコスコア

• A - Eの評価：環境への影響を示す
• 包装、輸送、生産方法を考慮

🔧 技術詳細

開発

テスト

# すべてのテストを実行
npm test

# ウォッチモード
npm run test:watch

# カバレッジレポート
npm run test:coverage

# コード品質の検証
npm run validate

コード品質

# 型チェック
npm run typecheck

# リント
npm run lint
npm run lint:fix

プロジェクト構造

src/
├── client.ts       # レート制限付きのHTTPクライアント
├── handlers.ts     # MCPツールの実装
├── index.ts        # MCPサーバーのエントリーポイント
├── tools.ts        # ツールの定義
└── types.ts        # TypeScriptの型とスキーマ

tests/
├── client.test.ts      # クライアントの単体テスト
├── handlers.test.ts    # ハンドラーの単体テスト
├── server.test.ts      # 統合テスト
├── validation.test.ts  # スキーマ検証テスト
├── rate-limiting.test.ts # レート制限テスト
├── e2e.test.ts        # エンドツーエンドテスト
├── fixtures/          # テストデータ
└── utils/            # テストユーティリティ

パフォーマンス

• レート制限：API制限の自動適用
• 効率的なキャッシュ：スマートなリクエスト重複排除
• バッチ操作：複数商品の比較を最適化
• エラー回復：APIエラーを適切に処理

API制限

サーバーはオープンフードファクツAPIのレート制限を尊重します。

• 商品クエリ：100リクエスト/分
• 検索クエリ：10リクエスト/分
• ファセットクエリ：2リクエスト/分

レート制限は適切なエラーメッセージとともに自動的に適用されます。

データソース

すべてのデータは世界最大のオープン食品データベースであるOpen Food Factsから取得されます。

• 150以上の国からの90万以上の商品
• 世界中の貢献者によって維持される共同データ
• 食品情報への無料アクセスを保証するオープンデータベースライセンス
• グローバルコミュニティからのリアルタイム更新

例

基本的な商品情報

**Nutella**
ブランド: Ferrero
数量: 400g
カテゴリ: 甘いスプレッド、チョコレートスプレッド

スコア:
ヌトリスコア: E | NOVAグループ: 4 | エコスコア: D

原材料:
砂糖、パーム油、ヘーゼルナッツ（13％）、脱脂粉乳...

栄養成分（100gあたり）:
エネルギー: 539 kcal | 脂肪: 30.9g | 炭水化物: 57.5g | 糖質: 56.3g

栄養分析

栄養分析: Nutella

スコア:
• ヌトリスコアE: 非常に低い栄養品質
• NOVAグループ4: 超加工食品
• エコスコアD: 高い環境影響

栄養成分内訳:
• エネルギー: 539 kcal（高い）
• 脂肪: 30.9g（高い）
• 糖質: 56.3g（高い）
• 塩分: 0.107g（低い）

🤝 コントリビュート

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. テストを含めて変更を加える
4. 品質チェックを実行する (npm run validate)
5. 変更をコミットする (git commit -m 'Add amazing feature')
6. ブランチにプッシュする (git push origin feature/amazing-feature)
7. プルリクエストを作成する

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Open Food Facts：包括的な食品データベースを提供してくれた
• Model Context Protocol：MCP仕様を提供してくれた
• 食品データの品質を維持する世界中のコントリビューターのコミュニティ

ヘルプが必要ですか？ 問題を開くか、例を確認して詳細な使用パターンを参照してください。