食品データを、AIとの会話へ

AIは、参照した根拠が誤っていたり曖昧だったりすると、一見もっともらしくても、誤った答えを返すことがあります。フードサーチMCPは、IMDが作成・確認・監査した食品データをOID、重量、取得時刻等とともに構造化して渡し、根拠データの不確かさを補います。ただし、AIの推論や最終回答が常に正しいことを無条件に保証するものではありません。

表示栄養値、商品・画像等の情報をもとに、IMD専属管理栄養士らが監修した独自レシピを作成します。日本食品標準成分表に準拠した食材と量で調理をデジタルに再現し、表示値との差が極力小さくなるよう調整したうえで、日本食品標準成分表に基づく栄養計算により、未表示の栄養項目を理論値として算出するためです。詳しくはIMDの栄養値算出方法をご覧ください。

両方を区別して収録します。メーカー・外食等が表示している栄養項目はその公式表示値、表示されていない項目は独自レシピと日本食品標準成分表を根拠に算出した理論値（推論値）です。後者を直接の実測値とは扱いません。

はい。普段のことばで目的を伝えると、対応AIクライアントが日本語のdescriptionとschemaを読み、利用可能なツール（tool）と引数を選びます。従来必要だったAPI操作やデータ整形をMCPとAIが仲立ちします。ただし、医療判断や専門的な栄養指導の最終判断は専門家へ相談してください。

接続先を登録できる対応AIクライアントであれば、スマートフォンから利用できます。MCPは根拠となる構造化データを返し、その後の表、グラフ、図、イラスト、Webページ、動画等への変換はAIクライアントの機能と利用条件に依存します。

はい。個人・法人を問わず、Streamable HTTP対応クライアントへ公開URLを登録して試せます。公開版は対話的な通常利用向けです。「適応型fair-use制御」がMCPの呼び出し回数、異なる検索語・OIDの連続取得、ページ走査、要求候補数等を総合的に評価し、IPアドレスだけでは遮断しません。自動収集、網羅取得、スクレイピング、継続的なバッチ処理には使用せず、まとまった取得にはAPIキー版を申請してください。継続提供や商用要件の保証はありません。

公開版を多くの方が公平に試せるよう、MCPの呼び出し回数、異なる検索語・OIDの連続取得、startを進めるページ走査、要求候補数等を総合的に評価する仕組みです。通常の対話利用を超える集中取得と判定した場合は、一時的に遮断することがあります。制限時はHTTP 429と、再試行までの秒数を示すRetry-After、判定状態を示すX-Foodsearch-Fair-Useを返します。指定された時間まで呼び出しを止め、並列実行、ページ走査、要求件数を減らしてください。

startは結果の開始位置（0始まり）、limitはその位置から返す件数です。公開/無償版のsearch_foodsは1回最大10件で、先頭50件の範囲だけを参照します。たとえばstart=20, limit=10は10件、start=45, limit=10は50件目未満までの5件、start=50以上は0件です。search_ingredientsも1回最大10件・位置0～49の範囲で、同じstart・limit規則を適用します。get_food_summaryはOIDを指定する1件取得で、limitはありません。内部検索APIとAPIキー版の検索は1回最大500件です。

40万件超はIMD食品データベース基盤全体の公表規模です。実際に取得できるデータは、検索語、ツール（tool）、公開版／APIキー版、契約scope、更新状況により異なり、すべての項目・レコードの取得を保証する表現ではありません。

申請フォームやメール確認なしで即時発行し、公開版では使えない高度な検索機能を当日中だけ試せるキーです。自動発行ではMCPのtools/callをJSTの1日10回、1応答の食品・商品を最大5件まで利用できます。接続初期化とtools/listは10回に含みません。

IPv4アドレスまたはIPv6の/64プレフィックスごとにJSTの1日1回です。同じブラウザーは完全キーと発行事実をlocalStorageへ当日中だけ保存し、別回線へ移動しても同じキーを再表示します。サイトデータを削除すると完全キーは復元できず、同じネットワークから当日中に再発行もできません。共有端末では利用後にサイトデータを削除してください。

上位3食材のおおよその分量（目安）に限り、指定したときだけ取得できます。トライアル・APIキー版のget_food_detailまたはcompare_foodsでinclude_ingredient_amounts=trueを指定すると、分量の多い順に上位3食材（水を除く）の目安分量approx_amount_g（食品1単位あたりのg）を返します。値は知的財産保護のためにIMD食品データベース側で丸めた目安で、1 g未満はそのまま、1 g以上10 g未満は2 g刻み、10 g以上100 g未満は10 g刻み、100 g以上は50 g刻みです。たとえば「150」は「およそ150 g」、「30」は「およそ30 g」を表し、実際の分量とは刻み幅程度前後するため、合計や比を正確な配合として扱わないでください。目安分量は1件につき標準20 token（1食品最大60 token）を追加で消費するため、必要なときだけ指定してください。全食材構成、食材件数、正確な分量・重さ・配合比、4番目以降の食材や水の分量は、公開版・トライアル版・APIキー版とも提供しません。分量を公開しないのは知的財産を保護するためで、栄養値の根拠が欠けているわけではありません。栄養値は、日本食品標準成分表（八訂）に準拠した食材構成をもとにIMD専属管理栄養士らが監修したレシピから算出した推定値、または商品の公式栄養成分表示の値です。compare_foodsの食材差分は引き続きOIDの有無だけで判定し、分量や割合は比較しません。

「原価」そのものは提供していません。代わりにAPIキー版のsearch_foods_advancedでrank_by_costを指定すると卸売原価指数（wholesale_cost_index）の順に検索でき、compare_foodsで複数OIDの指数差を、get_food_detailで基準日と直近約4週間の日次履歴を確認できます。卸売原価指数は、食品の食材構成を分解し、各食材の公的市場の卸売価格を分量で按分して合算した相対指数で、市場で取引のない時期は最終取引値を継続参照します。絶対額ではなく時間軸での変動を見る参考情報であり、調理、人件費、企画・製造、移動・物流、販売、広報・広告、返品、廃棄等のコストは含まず、現実の製造原価、売上原価、販売価格、利益を示す値ではありません。指数がない候補はランキングから除外します。旧identifier materialcostは廃止しました。

はい。英語の依頼では、MCPの利用説明がAIへ「食品名を自然な日本語検索語へ変換し、i18n_name_enも取得して日本語名との整合性を確認する」手順を案内します。英語名の取得（response_fieldsへのi18n_name_en指定）はトライアル・APIキー版で使えます。公開版は日本語名だけです。英語名がない場合はAIが補足翻訳できますが、その場合はデータベース収録名ではなくAIによる翻訳だと区別します。

はい。APIキー版のfind_similar_foodsが、名称・既知OID・構成マッチ抽象名のいずれかから構成マッチ食品OIDを解決し、同じ構成マッチ食品OIDに属する料理・食品・商品を人気順で返します。人気度は並び順だけに使用し、その数値は返しません。起点候補が複数ある場合はresolution_candidatesを確認し、source_result_indexで選択してください。

APIキー版のsearch_foods_advancedとfind_foods_by_ingredient_advancedで利用できます。味覚はtaste2_から始まるidentifierを相対的な強さのfilter／sortに使いますが、味覚ポイント値は返しません。色は最大3つのカラーコードを持ち、1番目を主色、2・3番目を補助色、3色同一を単色として照合します。色と発売期間は上流候補最大500件の範囲でMCP内照合します。発売期間の条件はsearch_foods_advancedだけで使えます（構成食材から逆引きできる食品には発売日の情報がないため）。

はい。APIキー版でfood:advanced scopeを付け、search_foods_advancedのnutrient_filtersへstuff_eの上限200を指定します。名称と数値条件は上流データベース検索時に同時適用されます。公開版のsearch_foodsは従来どおり名称・キーワード検索です。

商品についてコンタミネーションによる影響も想定されるので、IMDでは情報を収集していますが一般ご提供は致しておりません。

栄養値は重量、値の種別、取得時刻を併記し、商品についてはメーカーの最新表示も確認してください。医療診断、治療、服薬、摂取可否の最終判断には使用しないでください。

問い合わせフォームから、利用者名、所属、用途、必要scope、想定件数、利用期間、必要SLAを伝えて申請してください。本MCPの条件とIMDデータベース直接APIの契約は別です。完全キーは発行時だけ表示されます。

MCP endpointはWeb検索画面ではありません。この概要サイトで情報を確認し、実際の検索はMCPクライアントから行います。

0件はreturned_countが0の正常応答です。UPSTREAM_TIMEOUTなどは障害で、retryableとrequest_idが付きます。

正常です。APIキー版とfood:detail、food:recipeなど必要なscopeを申請してください。

できません。コンビニ商品がJANへ対応していない運用条件のため、本MCPはJAN検索とJAN関連項目を提供しません。

「適応型fair-use制御」が、MCPの呼び出し回数、異なる検索語・OIDの連続取得、ページ走査、要求候補数等から通常の対話利用を超える取得パターンを検出したか、サービス全体の非常上限に達したためです。レスポンスにはHTTP 429、Retry-After、X-Foodsearch-Fair-Useが含まれます。Retry-Afterで示された時間まで呼び出しを止め、並列実行、ページ走査、要求件数を減らしてください。IPアドレス単独の判定ではありません。継続利用、まとまった取得、定期処理にはAPIキー版を申請してください。

商品の画像は権利元・隣接権利元様への申請と許諾が必要であり、権利上利用できないと認識しています。但し、IMD 食品データベースでは全ての OID に対して、一般カテゴリとは異なる手法で構成マッチ食品OIDと構成マッチ抽象名を付与してきましたので、構成マッチ食品の抽象画像を今後ご提供することで、レファレンスとしてはご活用頂けるかと考えております。ご希望があればお問い合わせください。

この FAQ を作成している段階ではそのようなことはありませんが、この MCP サーバーは sakura インターネットの VPS を利用しており、弊社独自でも外部から稼働状況を監視しておりますので、負荷が大きくなった場合には増強や、ヘビーユーザなどに対する制限を検討致します。ただ、その場合には無償公開を制限したりスペックダウンを視野にすることもあり得ますので、公開維持のために効率的で合理的な自制的ご利用をぜひお願い致します。法人様で SLA などをお求めの方は、弊社へお問い合わせください。有償となりますが、貴社占有 VPS をご提供することも対応は可能です。（恐れ入りますが、特に日本法人ではない場合においては、要審査とさせて頂いております）

直ちに問い合わせフォームから無効化または削除を依頼してください。問い合わせ本文へ完全なキーを貼らないでください。