mcpField
O
Open Food Facts

Open Food Facts

ローカル
github.comヘルスケア34 日前に更新
リポジトリ公式サイト

Open Food Facts について

Open Food Factsは、Open Food Factsの食品データベースを検索・更新するMCPサーバーです。商品検索、条件指定、認証が必要なデータ編集に対応します。

主な機能

  1. 01バーコードによる商品検索
  2. 02構造化フィルターまたはLucene検索
  3. 03ブランドやカテゴリの入力補完
  4. 04商品データの追加・編集
  5. 05商品画像のアップロードと調整
  6. 06APIエンドポイントとドキュメントへのアクセス

活用シーン

  1. 01指定商品の栄養情報の確認
  2. 02バーコードから原材料を検索
  3. 03Nutri-Scoreでシリアルを検索
  4. 04商品情報や画像の追加

MCP 対応

Open Food Factsは、商品検索、照会、編集、画像、APIドキュメントのツールをMCPクライアントに提供します。書き込み操作には認証情報が必要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "domdomegg-openfoodfacts": {
      "command": "npx",
      "args": [
        "-y",
        "openfoodfacts-mcp"
      ],
      "env": {
        "OFF_USER_AGENT": "<OFF_USER_AGENT>",
        "OFF_USER_ID": "<OFF_USER_ID>",
        "OFF_PASSWORD": "<OFF_PASSWORD>",
        "OFF_COUNTRY": "<OFF_COUNTRY>",
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}
起動コマンドnpx -y openfoodfacts-mcp
設定が必要な環境変数
OFF_USER_AGENTUser-Agent string in format 'AppName/Version (email)'. Required by the Open Food Facts API.
OFF_USER_IDOpen Food Facts user ID (optional, needed for write operations).
OFF_PASSWORDシークレットOpen Food Facts password (optional, needed for write operations).
OFF_COUNTRYCountry subdomain (default: 'world').
MCP_TRANSPORTTransport type.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmopenfoodfacts-mcp2.6.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

openfoodfacts-mcp

Open Food Facts API 用の MCP サーバーです。世界最大のオープンな食品データベースを検索、閲覧し、データを提供できます。

ユースケース

商品名で商品を検索する：「Sainsbury's のバッファローチキンラップのカロリーはいくつですか？」→ 商品名で検索して商品を見つけ、栄養データを返します。

バーコードで商品を検索する：「バーコード 3017620422003 の商品には何が含まれていますか？」→ Nutella の原材料、Nutri-Score、栄養データを取得します。

健康的な商品を見つける：「Nutri-Score が A の朝食用シリアルを検索して」→ カテゴリーと栄養グレードのフィルターを使って検索します。

データを提供する：「バーコード 12345678 の商品の名前とブランドを追加して」→ Open Food Facts の商品エントリーを作成または更新します。

データベースを調べる：「データベースにはどのようなオーガニックチョコレートのブランドがありますか？」→ オートコンプリートと検索を使って調べます。

セットアップ

install-mcp の手順に従ってください。お使いの MCP クライアント（Claude Code、Claude Desktop、Cursor、Cline、VS Code など）に適した設定が生成されます。

アプリを識別するために OFF_USER_AGENT を設定してください（例：openfoodfacts-mcp/1.2.0 ([email protected])）。書き込み操作（商品の追加・編集、画像のアップロード）には、OFF_USER_ID と OFF_PASSWORD も設定してください。

環境変数

変数必須説明
OFF_USER_AGENTはいUser-Agent 文字列。例："AppName/1.0 ([email protected])"
OFF_USER_IDいいえOpen Food Facts のユーザー名（書き込み操作用）
OFF_PASSWORDいいえOpen Food Facts のパスワード（書き込み操作用）
OFF_COUNTRYいいえ国のサブドメイン（デフォルト：world）

ツール

ツール説明認証
get_productバーコードで商品情報を取得しますいいえ
search_products_standard構造化されたフィルター（ブランド、カテゴリー、Nutri-Score）で検索しますいいえ
search_products_luceneLucene 構文、否定、ブール論理を使って検索しますいいえ
autocompleteブランド、カテゴリー、ラベルなどをオートコンプリートしますいいえ
add_or_edit_product商品を追加または更新しますはい
upload_image商品画像をアップロードしますはい
select_image画像を選択、切り抜き、回転しますはい
call_api任意の OFF API エンドポイントを直接呼び出します場合によります
get_api_docsOFF API のドキュメントを取得しますいいえ

コントリビューション

GitHub でのプルリクエストを歓迎します。始めるには、次の手順に従ってください。

  1. Git と Node.js をインストールします
  2. リポジトリをクローンします
  3. npm install で依存関係をインストールします
  4. npm run test を実行してテストを実行します
  5. npm run build でビルドします

リリース

バージョンにはセマンティックバージョニング仕様を採用しています。

リリースするには、次の手順に従ってください。

  1. npm version <major | minor | patch> を使ってバージョンを更新します
  2. git push --follow-tags を実行してタグとともにプッシュします
  3. GitHub Actions が NPM レジストリに公開するまで待ちます。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。