リファレンス

あなたのAIができること、すべて

これらのツールを直接呼び出すことはありません — ただ話しかけるだけで、アシスタントが適切なツールを選びます。Nutrition MCPサーバーが公開する全ツールと、それぞれの機能、呼び出すきっかけとなるフレーズをまとめました。

36個のツール 7つの分野にわたる

このページはAIによって英語から翻訳されており、人による確認は行われていません。 英語の原文を読む

食事の記録

基本の流れ — どんな表現で伝えても、食べたものを記録します。

log_meal 記録 インタラクティブUI

食べたものをカロリーとマクロ栄養素とともに記録します — さらに数値がわかる場合は食物繊維、総糖類、アルコール、カフェインも記録できます。普段の言葉で説明するだけで、AIが数値を推定し、分量がはっきりしない場合は尋ね、必要に応じてバーコードやWeb検索から先にラベル情報を取得することもできます。

パラメーター
  • description 必須 — 何を食べたか
  • meal_type 必須 — 朝食、昼食、夕食、間食のいずれか
  • calories 任意 — 総カロリー
  • protein_g 任意 — タンパク質(グラム)
  • carbs_g 任意 — 炭水化物(グラム)
  • fat_g 任意 — 脂質(グラム)
  • fiber_g 任意 — 食物繊維(グラム)。ラベルに数値がない場合はAIが材料から推定し、すべての食事でこの項目を入力するよう指示されています。空欄はゼロを意味するのではなく、その日全体を食物繊維の平均から除外してしまうためです
  • sugar_g 任意糖類(グラム) — ラベルに「糖類」として表示される数値で、果物や牛乳に自然に含まれる糖分も含み、添加糖だけではありません。食物繊維と同じ基準で、すべての食事に入力されます
  • alcohol_g 任意純アルコールのグラム数であり、飲み物の量でもアルコール度数でもありません — AIが注いだ量と度数から算出します(330mlの5%のビールなら13g)
  • caffeine_mg 任意 — カフェインはミリグラム単位で、グラムではありません — ここで唯一グラム単位ではない項目です。これはあらゆるラベルやガイドラインがそう表記しているためです(ドリップコーヒーは約95mg、エスプレッソは63mg、コーラ1缶は34mg)。カフェインはカロリーを加えません。食物繊維や糖類と違い、実際にカフェインを含むものにのみ送信されます — 0を記録すると、あなたが一切摂取していない栄養素についてのカフェインの行がダッシュボードに表示されてしまいます
  • logged_at 任意 — 今でなければ、食べた時刻 — 後からの記録に使えます
  • notes 任意 — 追加のメモ
こう話しかけてみましょう

ランチにチキンブリトーボウルを、ワカモレ多めで記録して

…または、お皿の写真を撮るだけでも構いません — AIが各料理を特定し、日常的な単位(グラス1杯、ひとつかみなど)で分量を見積もり、これまでの記録内容と照合したうえで、記録する前にあなたに確認します。

lookup_barcode 検索

バーコード(8〜14桁のEAN/UPC)から、パッケージ商品の栄養成分をOpen Food Factsで検索します。数字を入力するか、パッケージの写真から読み取らせることができます。結果はそのまま、実際に食べた量に換算して記録できます。

こう話しかけてみましょう

このバーコードをスキャンして:3017620422003

…またはパッケージの写真を送ってください — AIがそこからバーコードの数字を読み取ります。

start_meal_import インポート インタラクティブUI

チャット内でインポーターを開き、他のアプリから履歴を取り込みます — MyFitnessPal、Cronometer、Lose It!、MacroFactorからエクスポートしたファイルを選び、その列をカロリー、マクロ栄養素、食物繊維、糖類、カフェイン(アルコール記録をオンにしている場合はアルコールも)に対応づけ、確定前に追加内容を確認できます。ファイルはブラウザ内で読み込まれ、プレビューを承認するまで何も保存されません。同じファイルを再度インポートしても重複は作成されません。

こう話しかけてみましょう

MyFitnessPalから食事履歴をインポートして

bulk_import_meals インポート

過去の食事をまとめて追加します — 一度に最大50件 — 1件ずつ記録する手間を省けます。上記のインポーターも内部でこのツールを使っており、AIはチャットに貼り付けられた食事データに対して直接使うこともできます。すべての行が事前にチェックされ、合わないものは行ごとに報告されるため、同じ行を再送しても安全で、すでに記録済みの内容が重複することはありません。

パラメーター
  • meals 必須 — インポートする行を、元ファイルの順序で指定します(1回の呼び出しにつき1〜50件)。各行には時刻、食事の種類、説明、メモ、そして記録済みの食事と同じ数値 — caloriesprotein_gcarbs_gfat_gfiber_gsugar_g(総糖類)、alcohol_g(純アルコールのグラム数)、caffeine_mg(ミリグラム、グラムではありません)— を含められます
  • expected_row_count 必須 — この呼び出しに含まれる行数を、元ファイルから数えたもの。行の欠落を検出するために使います
  • expected_total_kcal 任意 — 元ファイルのカロリー合計。届いた内容と照合されます
  • dry_run 任意 — 実際には何も書き込まずに、何が起こるかを報告します
  • on_error 任意 — 有効な行だけをインポートして残りを報告するか、いずれかの行が失敗した場合は何も書き込まないかを指定します
  • source_app 任意 — ファイルの取得元アプリ
こう話しかけてみましょう

先週の食事を古いアプリから貼り付けました — すべて追加して

update_meal 編集 インタラクティブUI

すでに記録した食事の内容 — 説明、各マクロ栄養素、食物繊維、糖類、アルコール、カフェイン、時刻、メモ — を変更します。抜けていた情報を後から埋める方法でもあります。食物繊維や糖類が入力されずに記録された場合、サーバーがそれを伝え、AIがここで入力します。

パラメーター
  • id 必須 — 更新する食事のUUID
  • description 任意
  • calories 任意
  • protein_g 任意
  • carbs_g 任意
  • fat_g 任意
  • fiber_g 任意
  • sugar_g 任意 — 総糖類であり、添加糖ではありません
  • alcohol_g 任意 — 純アルコールのグラム数であり、飲み物の量ではありません
  • caffeine_mg 任意 — ミリグラムであり、グラムではありません
  • logged_at 任意
  • notes 任意
こう話しかけてみましょう

そういえばあのランチは500カロリーじゃなくて600カロリーだった — 修正して

delete_meal 削除

誤って記録した食事のエントリを削除します。

パラメーター
  • id 必須 — 削除する食事のUUID
こう話しかけてみましょう

今日の午後に記録した間食を削除して

食事履歴の確認

記録した内容を、1日単位でも期間単位でも振り返れます。

search_meals 表示

過去の食事をキーワードで検索し、繰り返し登場する記録のバリエーションごとにまとめて表示します — それぞれの記録頻度、最後に記録した日時、標準的なカロリーなどです。AIがお皿の写真をこれまでの実際の記録内容と照合したり、「いつもの朝食を記録して」を実現したりするのに使われます。

パラメーター
  • queries 必須 — 食品に関するキーワードの候補。これまで記録に使ったどの言語でも構いません
  • days 任意 — どこまで遡るか(デフォルトは1年)
  • limit 任意 — 分析する最大エントリ数
こう話しかけてみましょう

いつもの朝食を記録して

get_meals_today 表示

今日記録したすべての食事を確認します。

こう話しかけてみましょう

今日は何を食べた?

get_meals_by_date 表示

特定の日に記録したすべての食事を確認します。

パラメーター
  • date 必須 — YYYY-MM-DD形式の日付
こう話しかけてみましょう

7月4日に食べたものを全部見せて

get_meals_by_date_range 表示

2つの日付の間のすべての食事を一度に取得します — 1週間や1か月分をまとめて振り返るのに便利です。

パラメーター
  • start_date 必須 — 開始日(YYYY-MM-DD)
  • end_date 必須 — 終了日(YYYY-MM-DD)
こう話しかけてみましょう

月曜から金曜までの食事を一覧にして

export_all_data エクスポート

記録したすべてのデータを1つのZIPとしてエクスポートします — meals.csv、water.csv、weight.csv、goals.csv、profile.csv、そして列と単位を説明するREADME.txt — 有効期限60分の同じプライベートリンクで提供されます。現時点で再インポートできるのは食事データのみです。

こう話しかけてみましょう

食事、水分、体重、目標など、すべてのデータをエクスポートして

水分

食事と合わせて水分摂取量を記録します。

log_water 記録

水分摂取を記録します。カップ、オンス、リットルなど任意の単位で入力でき、ミリリットルに自動変換されます。

パラメーター
  • amount_ml 必須 — ミリリットル単位の量(整数、> 0)。
こう話しかけてみましょう

500mlのボトルの水を飲んだところ

get_water_today 表示

今日の水分摂取量の合計と、各エントリを確認します。

こう話しかけてみましょう

今日はどれくらい水を飲んだ?

get_water_by_date 表示

特定の日の水分摂取量の合計とエントリを確認します。

パラメーター
  • date 必須 — YYYY-MM-DD形式の日付
こう話しかけてみましょう

昨日はどれくらい飲んだ?

delete_water 削除

誤って追加した水分エントリを削除します。

パラメーター
  • id 必須 — 削除する水分エントリのUUID
こう話しかけてみましょう

最後の水分エントリを削除して

体重

体重を記録・確認し、目標に向かう推移を見守ります。

log_weight 記録

体重測定値をkgまたはlbで記録します。1日に複数回記録しても問題なく、サーバーが正規の形式で保存するため、単位の設定によって数値が歪むことはありません。

パラメーター
  • weight 必須 — `unit`単位での体重の値(> 0)。
こう話しかけてみましょう

体重を記録して — 今朝は74.2kg

update_weight 編集

既存の体重記録 — 数値、タイムスタンプ、メモ — を修正します。

パラメーター
  • id 必須 — 更新する体重記録のUUID
  • weight 任意 — `unit`単位での新しい体重の値。
  • logged_at 任意 — ISO 8601形式のタイムスタンプ
  • notes 任意
こう話しかけてみましょう

今朝の体重記録を73.8kgに修正して

delete_weight 削除

体重記録を削除します。

パラメーター
  • id 必須 — 削除する体重記録のUUID
こう話しかけてみましょう

今日の体重記録を削除して

get_weight_today 表示

今日の体重記録を、お好みの単位で確認します。

こう話しかけてみましょう

今日の体重はどうだった?

get_weight_by_date 表示

特定の日の体重記録を確認します。

パラメーター
  • date 必須 — YYYY-MM-DD形式の日付
こう話しかけてみましょう

1日の体重はどうだった?

get_weight_by_date_range 表示

2つの日付の間のすべての体重記録を、日ごとの平均とともにグループ化して取得します。

パラメーター
  • start_date 必須 — 開始日(YYYY-MM-DD)
  • end_date 必須 — 終了日(YYYY-MM-DD)
こう話しかけてみましょう

この2週間の体重記録を見せて

set_weight_unit 設定

体重の表示・入力単位をkgとlbのどちらにするか選びます。保存されている値自体は変わりません — 表示とデフォルトの解釈のみが変わります。

こう話しかけてみましょう

これから体重はポンドで表示して

目標と進捗

目標を設定し、毎日の達成度を確認します。

set_nutrition_goals 設定

カロリー、マクロ栄養素、食物繊維、糖類、アルコール、カフェイン、水分の1日の目標を設定し、任意で目標体重も設定できます。カロリー、タンパク質、炭水化物、脂質、食物繊維、水分は達成すべき目標値、糖類、アルコール、カフェインは超えないようにすべき上限値であり、進捗の表現もそれに応じて変わります。指定したフィールドのみが更新され、それ以外はそのまま維持されます。

パラメーター
  • daily_calories 任意 — 1日のカロリー目標(kcal)。nullでクリア。
  • daily_protein_g 任意 — 1日のタンパク質目標(グラム)。nullでクリア。
  • daily_carbs_g 任意 — 1日の炭水化物目標(グラム)。nullでクリア。
  • daily_fat_g 任意 — 1日の脂質目標(グラム)。nullでクリア。
  • daily_fiber_g 任意 — 1日の食物繊維目標(グラム)— 達成すべき最小値です。nullでクリア。
  • daily_sugar_g 任意 — 1日の糖類の上限(グラム)— 超えないようにすべき最大値です。総糖類には果物や牛乳に自然に含まれる糖分も含まれるため、公的な添加糖ガイドラインの数値よりかなり大きくなります。nullでクリア。
  • daily_alcohol_g 任意 — 1日のアルコール上限を純アルコールのグラム数で指定します — 超えないようにすべき最大値です。米国の標準的な1杯は14g、英国の1ユニットは7.9gです。nullでクリア。
  • daily_caffeine_mg 任意 — 1日のカフェイン上限をミリグラム単位で指定します — 超えないようにすべき最大値です。EFSAおよびFDAが定める健康な成人の上限は1日400mg(ドリップコーヒー約4杯分)、妊娠中は200mgです。0は「まったく摂らない」という実際の上限を意味します。nullでクリア。
  • daily_water_ml 任意
  • target_weight 任意
こう話しかけてみましょう

目標をカロリー2,200、タンパク質160g、目標体重75kgに設定して

get_nutrition_goals 表示

現在のカロリー・マクロ栄養素の1日の目標、食物繊維の目標、糖類やカフェインの上限、そして(アルコールを記録している場合は)アルコールの上限を確認します。

こう話しかけてみましょう

1日の目標は何?

get_goal_progress 表示 インタラクティブUI

今日の摂取量が目標に対してどうなっているかを確認します — 摂取量対目標のリングと体重の進捗です。マクロのリングをタップすると、どの食事が寄与したかがわかります。

こう話しかけてみましょう

今日の目標に対する達成状況は?

get_nutrition_summary 表示 インタラクティブUI

期間内の1日ごとの栄養合計を、インタラクティブなダッシュボードとして取得します:目標に対するマクロのタイルと、日ごとの内訳です。

パラメーター
  • start_date 必須 — 開始日(YYYY-MM-DD)
  • end_date 必須 — 終了日(YYYY-MM-DD)
こう話しかけてみましょう

先週分のサマリーをちょうだい

設定とアカウント

すべてを正確に保つための各種設定と、データの完全な管理。

get_profile 表示

現在の設定を一度に確認します:タイムゾーン(現地の日付と時刻も)、ウィジェットの言語、優先する体重の単位、チャット内ウィジェットを表示するかどうか、アルコール記録がオンかどうか。

こう話しかけてみましょう

今の設定を教えて

set_timezone 設定

IANAタイムゾーンを設定し、日付が現地時間の深夜0時で切り替わるようにします — 午後11時に記録した食事は、翌日のUTCとしてではなく、その日としてカウントされます。

こう話しかけてみましょう

ベルリンにいます — タイムゾーンを設定して

set_language 設定

チャット内ウィジェット(ダッシュボードやグラフ)のUI言語を設定します。AIがあなたに返す文章の言語ではありません。

パラメーター
  • locale 必須 — ISO 639-1コード。例:deuk。対応言語:英語、ドイツ語、スペイン語、フランス語、オランダ語、ポーランド語、イタリア語、ウクライナ語。
こう話しかけてみましょう

ウィジェットをドイツ語で表示して

get_current_time 表示

あなたのタイムゾーンでの現在の日付と時刻、そしてUTCでの時刻を確認します。今が何時かをアシスタントに伝えないアプリもあるため、これは「今朝」や「今日」が何を指すかを、あなたに尋ねずに判断するための仕組みです(タイムゾーンが未設定の場合はUTCが既定になります)。

こう話しかけてみましょう

今の私の時間は何時?

set_widget_display 設定

チャット内のビジュアルウィジェット — ダッシュボード、目標リング、トレンドグラフ — のオン/オフを切り替えます。オフにすると、同じツールがテキストとデータのみで応答します。デフォルトで有効で、変更は新しい会話から適用されます。

パラメーター
  • enabled 必須 — trueでウィジェットを表示、falseでテキストのみの応答
こう話しかけてみましょう

ウィジェットをオフにして

set_alcohol_tracking 設定

アルコール記録のオン/オフを切り替え、飲み物を米国の標準ドリンクと英国のユニットのどちらでカウントするかを選びます。デフォルトではオフなので、有効にするには明示的にリクエストする必要があります。再びオフにすると、食事・目標・進捗からアルコールが非表示になり、ファイルインポーターもファイルのアルコール列を読み込まなくなります。すでに記録された内容が削除されることはなく、CSVエクスポートには引き続き含まれ、再度オンにすれば表示が戻ります。変更は次のメッセージから適用され、再起動などは不要です。

パラメーター
  • enabled 必須 — trueで食事・目標・進捗にアルコールを表示、falseで非表示
  • drink_unit 任意 — グラム数と併せて表示する標準ドリンクの単位:us(1杯14g)またはuk(1ユニット7.9g)。デフォルトはus。実際に保存されるのは純アルコールのグラム数です。
こう話しかけてみましょう

飲酒の記録を英国ユニットで始めて

delete_account 削除

アカウントと関連するすべてのデータを完全に削除します。これは取り消せません — AIは必ず事前に確認します。

こう話しかけてみましょう

アカウントとすべてのデータを削除して