リファレンス · 全55ツール · 7分野

お使いのAIにできること、すべて

ツールを直接呼び出す必要はありません。Claude、ChatGPTなどのMCPクライアントに話しかけるだけで、AIが適切なツールを選びます。ここでは、Nutrition MCPサーバーが提供する食事と保存した食事・カロリーとPFC・水分・体重のツールをすべて取り上げ、それぞれの機能と、そのツールが使われるきっかけになるフレーズを紹介します。

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

食事の記録

基本となる機能。食べたものを、どんな言い方で伝えても記録できます。よく食べる食事は保存しておけば、次から一言で記録できます。

記録インタラクティブUI

log_meal

食べたものをカロリーとマクロ栄養素つきで記録します。数値がわかれば、飽和脂肪酸・トランス脂肪酸・食物繊維・総糖類・添加糖・ナトリウム・アルコール・カフェインも記録できます。ふだんの言葉で伝えるだけで、AIが数値を推定し、量がはっきりしないときは確認します。先にバーコードやWebからラベル情報を取得することもできます。材料を1つずつ渡すこともできます。その場合、食事の合計はそれら材料の合計になります。

パラメーター
  • description必須何を食べたか
  • meal_type必須朝食・午前の間食・昼食・おやつ・夕食・夜食・トレーニング前・トレーニング後・間食のいずれか
  • calories任意総カロリー
  • protein_g任意タンパク質(グラム)
  • carbs_g任意炭水化物(グラム)
  • fat_g任意脂質(グラム)
  • saturated_fat_g任意任意。飽和脂肪酸(グラム)。fat_g の一部で、fat_g を超えることはありません。空欄は「未測定」として保存され、その日は飽和脂肪酸の平均と上限から除外されます。含まない食品には 0 を入れます。
  • trans_fat_g任意任意。トランス脂肪酸(グラム)。fat_g とは別の脂肪の種類で、fat_g と照合されることはありません。上限はなく、記録された場所にだけ表示されます。含まない食品には 0 を入れます。
  • fiber_g任意食物繊維(グラム)。ラベルに数値がなければ材料から推定してでも、すべての食事で入力するようAIに指示されています。空欄はゼロ扱いにはならず、その日全体が食物繊維の平均から外れてしまうためです
  • sugar_g任意総糖類(グラム)。ラベルの「糖類」欄に表示される数値で、添加糖だけでなく果物や牛乳に自然に含まれる糖も含みます。食物繊維と同じく、すべての食事で入力されます
  • added_sugar_g任意添加糖(グラム)。加工や調理の際に加えられた糖(砂糖、シロップ、はちみつ、甘味飲料や加糖食品の糖)です。総糖類の一部で、それを超えることはありません。丸ごとの果物、野菜、無糖の牛乳に自然に含まれる糖は添加糖ではなく、果汁100%ジュースの糖も同様です。食物繊維と同じく、すべての食事で入力されます。未加工の食品は0、清涼飲料の糖はすべて添加糖で、米国のラベルに「Includes Xg Added Sugars」の行があればその値を使います。sugar_gとセットで指定します。総糖類があり添加糖がない食事は保存されない場合があります
  • alcohol_g任意純アルコールのグラム数。飲み物の量でもアルコール度数でもありません。AIが注いだ量と度数から計算します(5%のビール330 mlなら13 g)
  • caffeine_mg任意カフェインはミリグラム単位で、グラムではありません。ここでグラム単位でないのはこの項目だけで、どの表示ラベルやガイドラインもミリグラムで表記しているためです(ドリップコーヒーは約95 mg、エスプレッソは63 mg、コーラ1缶は34 mg)。カフェインにカロリーはありません。食物繊維や糖類と違い、実際にカフェインを含むものにだけ送信されます。0を記録すると、まったく摂っていないカフェインの行がダッシュボードに表示されてしまうためです
  • sodium_mg任意任意。ナトリウム(ミリグラム)。食塩ではなくナトリウムの量です(食塩1 gにはナトリウムが約400 mg含まれます)。空欄は「未測定」として保存され、その日はナトリウムの平均と上限から除外されます。含まない食品には 0 を入れます。
  • logged_at任意食べた時刻(今ではない場合)。後から記録するときに使います
  • notes任意追加のメモ
  • items任意材料を1行ずつ、分量と栄養成分つきで指定します。各材料にはcalories、protein_g、carbs_g、fat_gが必要です。fiber_g、sugar_g、added_sugar_gはすべての材料に入力するか、どの材料にも入力しません。alcohol_gとcaffeine_mgはそれを含む材料にだけ入力し、その材料の分が合計されます。食事の合計は材料の合計になるため、材料と合計値は一緒に送らず、どちらか一方を送ります

こう話しかけてみましょう 「お昼にチキンブリトーボウル、ワカモレ多めで記録して」

…または、お皿の写真を撮るだけでもOK。AIが料理を一つずつ特定し、グラス1杯、ひとつかみといった身近な単位で量を見積もり、過去にどう記録したかも参照したうえで、記録する前に確認します。

検索

lookup_barcode

バーコード(8〜14桁のEAN/UPC)から、パッケージ商品の栄養成分表示をOpen Food Factsで取得します。Open Food FactsにNutri-ScoreやNOVA分類(加工度のグループ)があれば、それも取得します。Open Food Factsに添加糖の値があれば表示し、Open Food Factsが原材料から推定した値であればその旨を示します。数字は入力しても、パッケージの写真から読み取ってもかまいません。結果は、実際に食べた量に換算して記録できます。

こう話しかけてみましょう 「このバーコードをスキャンして:3017620422003」

…または、パッケージの写真を送るだけでもOK。AIが写真からバーコードの数字を読み取ります。

検索

search_foods

英語の食品名で USDA FoodData Central の一般食品(Foundation、SR Legacy、Survey/FNDDS のデータ)を検索し、最大10件の候補を返します。各候補には FoodData Central の ID、USDA の説明、データの種類、100 g あたりのエネルギーと栄養素が含まれます。一致は USDA の英語表記に基づきます(例:「cooked, boiled」)。

パラメーター
  • query必須英語の食品名(200文字まで)。例:banana、lentils, cooked

こう話しかけてみましょう 「USDA では生のバナナはどう記録されている?」

検索

get_food_macros

一般食品1点について、FoodData Central の ID で USDA の値を返します。100 g あたりの値と、amount_g を指定した場合はその量に換算した値、さらに USDA が記載している一人前の量を含みます。その食品について USDA が記録していない栄養素は「記録なし」と表示され、0 として扱われることはありません。食事ツールがこれらの値に対して受け付ける food_ref も含まれます。

パラメーター
  • fdc_id必須食品の FoodData Central ID(search_foods の結果に表示されるもの)
  • amount_g任意任意。値を換算する量(グラム)。0 より大きく 5,000 まで

こう話しかけてみましょう 「このバナナ150 g の USDA 値は?」

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

start_meal_import

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

こう話しかけてみましょう 「MyFitnessPalから食事の履歴をインポートして」

インポート

bulk_import_meals

過去の食事を1件ずつ記録する代わりに、まとめて追加します(1回につき最大50件)。上のインポーターもこのツールを通して書き込んでおり、チャットに貼り付けた食事データならAIが直接使うこともできます。すべての行を事前にチェックし、合わない行は1行ずつ報告します。そのため、間にタイムゾーンを変更していなければ、同じ行を再送しても安全で、記録済みの内容が重複することはありません。

パラメーター
  • meals必須インポートする行。元ファイルの順序で指定します(1回につき1〜50件)。各行には時刻、食事の種類、説明、メモと、記録済みの食事と同じ数値を含められます:calories、protein_g、carbs_g、fat_g、saturated_fat_g、trans_fat_g、fiber_g、sugar_g(総糖類)、added_sugar_g(添加糖、総糖類の一部)、alcohol_g(純アルコールのグラム数)、caffeine_mg(グラムではなくミリグラム)、sodium_mg(食塩ではなくナトリウムのミリグラム数)
  • expected_row_count必須この呼び出しに含まれる行数(元ファイルで数えたもの)。行の抜け落ちを検出するために使います
  • expected_total_kcal任意元ファイルのカロリー合計。受け取った内容と照合します
  • dry_run任意何も書き込まずに、実行した場合の結果を報告します
  • on_error任意有効な行だけをインポートして残りを報告するか、1行でも失敗したら何も書き込まないか
  • source_app任意ファイルのエクスポート元のアプリ

こう話しかけてみましょう 「前のアプリから先週の食事を貼り付けたよ。全部追加して」

編集インタラクティブUI

update_meal

記録済みの食事の内容(説明、各マクロ栄養素、食物繊維、総糖類、添加糖、ナトリウム、アルコール、カフェイン、時刻、メモ)を変更します。抜けている値を後から補うときにも使います。食物繊維、糖類、添加糖が入らないまま記録された場合はサーバーがそのことを伝え、同意すればAIがここで入力します。材料つきで記録した食事では、合計値は材料リストを通じて変わります。

パラメーター
  • id必須更新する食事のUUID
  • description任意
  • calories任意
  • protein_g任意
  • carbs_g任意
  • fat_g任意
  • saturated_fat_g任意任意。飽和脂肪酸(グラム)。fat_g の一部で、fat_g を超えることはありません。空欄は「未測定」として保存され、その日は飽和脂肪酸の平均と上限から除外されます。含まない食品には 0 を入れます。
  • trans_fat_g任意任意。トランス脂肪酸(グラム)。fat_g とは別の脂肪の種類で、fat_g と照合されることはありません。上限はなく、記録された場所にだけ表示されます。含まない食品には 0 を入れます。
  • fiber_g任意
  • sugar_g任意総糖類(添加糖ではありません)
  • added_sugar_g任意添加糖のみ(総糖類を超えることはありません)。sugar_gとセットで指定します。添加糖が未記録の食事で総糖類を変更する場合、この値がないと保存されないことがあります
  • alcohol_g任意純アルコールのグラム数(飲み物の量ではありません)
  • caffeine_mg任意グラムではなくミリグラム
  • sodium_mg任意食塩ではなくナトリウムのミリグラム数
  • logged_at任意
  • notes任意
  • items任意材料の完全なリスト(既存のリストを置き換えます)。食事の合計はこのリストの合計になるため、合計値のフィールドは一緒に送れません

こう話しかけてみましょう 「やっぱりあのお昼、500カロリーじゃなくて600カロリーだった。直して」

削除

delete_meal

間違えて記録した食事を削除します。

パラメーター
  • id必須削除する食事のUUID

こう話しかけてみましょう 「今日の午後に記録した間食を消して」

記録

save_meal

食べることの多い食事に名前をつけて保存します。例えば「いつもの朝食」のように。1食分の数値と、わかっていれば材料も保存できます。数値は自分で入力するか、記録済みの食事からコピーします。保存しても食事日記には何も追加されません。食べたときはlog_saved_mealで記録します。

パラメーター
  • name必須保存名。保存済みの食事の中で一意である必要があります(1〜100文字)
  • from_meal_id任意値と材料をコピーする、記録済みの食事のUUID
  • description任意この食事の説明。省略すると保存名になります
  • meal_type任意朝食・午前の間食・昼食・おやつ・夕食・夜食・トレーニング前・トレーニング後・間食のいずれか。記録するときの既定値になります
  • items任意材料を1行ずつ、分量と栄養成分つきで指定します。材料の合計が保存する食事の数値になるため、材料と数値は一緒に送れません
  • calories任意1食分の総カロリー
  • protein_g任意1食分のタンパク質(グラム)
  • carbs_g任意1食分の炭水化物(グラム)
  • fat_g任意1食分の脂質(グラム)
  • saturated_fat_g任意任意。飽和脂肪酸(グラム)。fat_g の一部で、fat_g を超えることはありません。空欄は「未測定」として保存され、その日は飽和脂肪酸の平均と上限から除外されます。含まない食品には 0 を入れます。
  • trans_fat_g任意任意。トランス脂肪酸(グラム)。fat_g とは別の脂肪の種類で、fat_g と照合されることはありません。上限はなく、記録された場所にだけ表示されます。含まない食品には 0 を入れます。
  • fiber_g任意1食分の食物繊維(グラム)
  • sugar_g任意1食分の総糖類(グラム)
  • added_sugar_g任意1食分の添加糖(グラム)。総糖類を超えることはありません。sugar_gとセットで指定します
  • alcohol_g任意1食分の純アルコールのグラム数。飲み物の量ではありません
  • caffeine_mg任意1食分のカフェインのミリグラム数。グラムではありません
  • sodium_mg任意1食分のナトリウムのミリグラム数。食塩の量ではありません

こう話しかけてみましょう 「いつもの朝食として保存して」

記録インタラクティブUI

log_saved_meal

保存した食事を、今、または指定した時刻の食事記録として記録します。記録には保存済みの数値と材料のコピーが入り、servingsで量を調整できます。今回だけ、個々の材料を実際に食べた分量にしたり、抜いたりすることもできます。保存した食事を後から変更しても、そこから記録済みの食事は変わりません。

パラメーター
  • saved_meal必須保存した食事の名前、または get_saved_meals や search_meals で得たID
  • servings任意記録する食数(0より大きく20まで。デフォルトは1)
  • item_amounts任意今回の記録で実際に食べた個々の材料の分量。名前または位置で指定します。まずservingsで保存した食事全体の量を調整し、そのあと指定した材料の分量をこの値にします。その材料の栄養成分は分量の比率に応じて変わります
  • leave_out任意この記録から外す材料。名前または位置で指定します
  • meal_type任意朝食・午前の間食・昼食・おやつ・夕食・夜食・トレーニング前・トレーニング後・間食のいずれか。保存した食事の既定値を上書きします
  • description任意この記録の説明。省略すると保存した食事の説明になります
  • logged_at任意食べた時刻(今ではない場合)
  • notes任意追加のメモ
  • idempotency_key任意同じ呼び出しを再送しても、同じ記録が2重にならないようにするキー

こう話しかけてみましょう 「いつもの朝食を半分の量で記録して」

編集

update_saved_meal

保存した食事の名前、説明、既定の食事の種類、材料、1食分あたりの数値を変更します。そこから記録済みの食事は、それまでの数値のまま残ります。

パラメーター
  • id必須更新する保存済みの食事のUUID
  • name任意新しい名前。保存済みの食事の中で一意である必要があります
  • description任意新しい説明
  • meal_type任意新しい既定の食事の種類:朝食・午前の間食・昼食・おやつ・夕食・夜食・トレーニング前・トレーニング後・間食のいずれか
  • items任意材料の完全なリスト(既存のリストを置き換えます)。その合計が保存した食事の数値になるため、数値のフィールドは一緒に送れません
  • calories任意1食分の総カロリー
  • protein_g任意1食分のタンパク質(グラム)
  • carbs_g任意1食分の炭水化物(グラム)
  • fat_g任意1食分の脂質(グラム)
  • saturated_fat_g任意任意。飽和脂肪酸(グラム)。fat_g の一部で、fat_g を超えることはありません。空欄は「未測定」として保存され、その日は飽和脂肪酸の平均と上限から除外されます。含まない食品には 0 を入れます。
  • trans_fat_g任意任意。トランス脂肪酸(グラム)。fat_g とは別の脂肪の種類で、fat_g と照合されることはありません。上限はなく、記録された場所にだけ表示されます。含まない食品には 0 を入れます。
  • fiber_g任意1食分の食物繊維(グラム)
  • sugar_g任意1食分の総糖類(グラム)
  • added_sugar_g任意1食分の添加糖(グラム)。総糖類を超えることはありません。sugar_gとセットで指定します
  • alcohol_g任意1食分の純アルコールのグラム数。飲み物の量ではありません
  • caffeine_mg任意1食分のカフェインのミリグラム数。グラムではありません
  • sodium_mg任意1食分のナトリウムのミリグラム数。食塩の量ではありません

こう話しかけてみましょう 「いつもの朝食は今、1食あたり350 kcalになった。更新して」

削除

delete_saved_meal

保存した食事を削除します。そこから記録済みの食事は、それまでの数値のまま残ります。

パラメーター
  • id必須削除する保存済みの食事のUUID

こう話しかけてみましょう 「古い昼食という保存済みの食事を削除して」

食事の振り返り

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

表示

search_meals

キーワードで過去の食事を検索し、よく記録する食事をバリエーションごとにまとめて表示します。それぞれの記録回数、最後に記録した日、いつものカロリーがわかります。お皿の写真を実際の過去の記録と照らし合わせたり、「いつもの朝食を記録して」に応えたりするときに、AIがこのツールを使います。食事の材料名も検索対象で、名前・説明・材料が一致する保存した食事も一覧に表示します。

パラメーター
  • queries必須食品を表すキーワードの候補(これまで記録に使ったどの言語でも可)
  • days任意どこまでさかのぼるか(デフォルトは1年)
  • limit任意分析する最大件数

こう話しかけてみましょう 「いつもの朝食を記録して」

検索

find_my_food

Find a food in your own foods — everything you've logged with an amount, plus foods brought in from an export. Every word you say must be in the food's name, so "chicken thigh" never turns into the chicken breast you log more often. When one of your regular foods is the clear match it says so; when several match with different values (a nonfat and a whole-milk yogurt), you're asked which one you meant. The match can then be logged at any amount, with its values scaled by the server.

パラメーター
  • queries必須The food as you'd name it, with any brand, cut or preparation words

こう話しかけてみましょう 「Log 300 g of chicken thigh」

設定

set_food_keyword

Save the words you use for one of your foods, so they always find that food: "strawberry" → the strawberries you mean, "yogurt" → your usual one. When a search isn't sure which food you meant, you confirm it once and can save it as a keyword. Saving a keyword again moves it; leaving out the food removes it.

パラメーター
  • keyword必須The words you use for the food
  • my_food_id任意The food they mean (from find_my_food); leave out to remove the keyword

こう話しかけてみましょう 「Yes, and always use that one when I say yogurt」

表示

get_meals_today

今日記録した食事をすべて表示します。

パラメーター
  • detail任意compact(デフォルト)は1食につきIDつきの1行、fullはメモと正確な時刻も表示します

こう話しかけてみましょう 「今日、何食べたっけ?」

表示

get_meals_by_date

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

パラメーター
  • date必須YYYY-MM-DD形式の日付
  • detail任意compact(デフォルト)は1食につきIDつきの1行、fullはメモと正確な時刻も表示します

こう話しかけてみましょう 「7月4日に食べたものを全部見せて」

表示

get_meals_by_date_range

2つの日付の間の食事をまとめて取得します。1週間や1か月を振り返るのに便利です。1回で取得できるのは最大31日分で、それより長い期間はトレンドやサマリーで日ごとの合計を確認できます。

パラメーター
  • start_date必須開始日(YYYY-MM-DD)
  • end_date必須終了日(YYYY-MM-DD)。開始日を含めて最大31日
  • detail任意compact(デフォルト)は1食につきIDつきの1行、fullはメモと正確な時刻も表示します

こう話しかけてみましょう 「月曜から金曜までの食事を一覧にして」

表示

get_saved_meals

保存した食事を、1食分あたりの数値と材料つきで表示します。名前に特定の文字列を含むものだけに絞ることもできます。

パラメーター
  • name_contains任意名前にこの文字列を含む保存済みの食事だけ

こう話しかけてみましょう 「保存した食事は何がある?」

エクスポート

export_all_data

本サービスが保存しているあなたのデータを、すべて1つのZIPにまとめてエクスポートし、60分間有効な非公開のダウンロードリンクを返します。中身はmeals.csv、meal_items.csv(記録した食事ごとの材料)、saved_meals.csv と saved_meal_items.csv(保存した食事とその材料)、water.csv、active_calories.csv、weight.csv、body_measurements.csv、goals.csv、goals_history.csv(目標の変更履歴と日付)、profile.csv、account.csv(サインイン用アカウント)、telemetry.csv(ツールの利用記録)、connections.csv(接続中のAIアプリとApple Health同期。トークンは含みません)、health_sync.csv(Apple Health同期が直近8日間に送信した内容)と、列・単位・含まれないものを説明したREADME.txtです。現時点で再インポートできるのは食事データだけです。

こう話しかけてみましょう 「食事・水分・体重・目標、データを全部エクスポートして」

水分記録

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

記録

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から選びます。保存済みの値は変わらず、変わるのは表示と、単位なしで入力したときの解釈だけです。

こう話しかけてみましょう 「これからは体重をポンドにして」

記録

log_body_measurement

メジャーで測った体の1部位の計測値(ウエスト、ヒップ、首、胸囲、肩幅、上腕、前腕、太もも、ふくらはぎ)を、cmまたはインチで記録します。入力したとおりの値を標準化した値とあわせて保存するため、単位を切り替えても数値がずれることはありません。その部位として現実的な範囲から大きく外れた数値は、入力ミスの可能性が高いものとして受け付けません。

パラメーター
  • kind必須部位:waist、hips、neck、chest、shoulders、upper_arm、forearm、thigh、calfのいずれか。1部位につき値は1つで、左右の区別はメモに書けます。
  • value必須unitで指定した単位の計測値(> 0)。
  • unit任意cmまたはin。省略時は保存済みの長さの単位。
  • logged_at任意測った時刻(今ではない場合)
  • notes任意追加のメモ

こう話しかけてみましょう 「ウエストを記録して。今朝は82cm」

表示

get_body_measurements

体の計測値を日ごとに古い順で一覧表示します。1つの部位だけに絞ることもできます。日付を指定しなければ直近30日間が対象で、1回あたり最大366日まで指定できます。

パラメーター
  • kind任意この部位だけ(例:waist)
  • start_date任意開始日(YYYY-MM-DD)
  • end_date任意終了日(YYYY-MM-DD)。開始日を含めて最大366日

こう話しかけてみましょう 「この3か月のウエストの計測値を見せて」

編集

update_body_measurement

記録済みの計測値(数値、単位、日時、メモ)を修正します。部位そのものは変更できず、別の部位は新しい記録になります。

パラメーター
  • id必須更新する計測値のUUID
  • value任意unitで指定した単位の新しい値。
  • unit任意省略時は記録したときの単位。
  • logged_at任意ISO 8601形式のタイムスタンプ
  • notes任意置き換えるメモ

こう話しかけてみましょう 「ヒップの計測値、89じゃなくて98cmだった」

削除

delete_body_measurement

体の計測値の記録を削除します。

パラメーター
  • id必須削除する計測値のUUID

こう話しかけてみましょう 「今日の首の計測値を消して」

設定

set_length_unit

体の計測値の表示と入力の単位を、cmとインチから選びます。体重の単位とは別の設定です。保存済みの値は変わらず、変わるのは表示と、単位なしで入力したときの解釈だけです。

こう話しかけてみましょう 「計測値はこれからインチで表示して」

目標と進捗

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

設定

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_saturated_fat_g任意1日の飽和脂肪酸の上限(グラム)。null で解除。
  • daily_fiber_g任意1日の食物繊維目標(グラム)。達成を目指す最低量です。nullでクリア。
  • daily_sugar_g任意1日の総糖類の上限(グラム)。超えないようにする最大量です。総糖類には果物や牛乳に自然に含まれる糖も含まれるため、公的機関が示す添加糖の目安はこれよりずっと低い数値です。nullでクリア。
  • daily_added_sugar_g任意1日の添加糖の上限(グラム)。超えないようにする最大量です。添加糖だけを数え、果物や牛乳に自然に含まれる糖は含みません。公的機関が示す糖の目安は、たいていこの指標を指しています(米国心臓協会(American Heart Association)は女性で1日25g、男性で36gまでとしています)。0は「まったくとらない」という実際の上限です。nullでクリア。
  • daily_alcohol_g任意1日のアルコール上限(純アルコールのグラム数)。超えないようにする最大量です。US標準ドリンクは1杯14 g、UKユニットは1ユニット7.9 gです。nullでクリア。
  • daily_caffeine_mg任意1日のカフェイン上限(ミリグラム)。超えないようにする最大量です。EFSAとFDAは健康な成人の上限を1日400 mg(ドリップコーヒー約4杯分)としており、妊娠中についてはEFSAが200 mgとしています。0は「まったく摂らない」という実際の上限として扱われます。nullでクリア。
  • daily_sodium_mg任意1日のナトリウム上限(ミリグラム)。超えないようにする最大量で、食塩ではなくナトリウムの量です。WHOは成人について1日2,000 mg未満、米国の食事ガイドラインは2,300 mg未満としています。0は「まったく摂らない」という実際の上限として扱われます。nullでクリア。
  • daily_water_ml任意
  • target_weight任意

こう話しかけてみましょう 「目標をカロリー2,200、タンパク質160g、目標体重75kgに設定して」

表示

get_nutrition_goals

現在の1日のカロリー・マクロ栄養素の目標と、食物繊維の目標、糖類・カフェイン・ナトリウムの上限、さらに(アルコールを記録している場合は)アルコールの上限を表示します。

こう話しかけてみましょう 「1日の目標って何だっけ?」

表示インタラクティブUI

get_goal_progress

今日の摂取量が目標に対してどのくらいかを確認します。摂取量と目標を比べるリングと、体重の進捗を表示します。PFCのリングをタップすると、どの食事によるものかがわかります。

こう話しかけてみましょう 「今日の目標に対して、いまどんな感じ?」

表示インタラクティブUI

get_nutrition_summary

期間内の1日ごとの栄養の合計を、インタラクティブなダッシュボードで表示します。目標と比べたPFCのタイルと、日ごとの内訳を確認できます。1回で取得できるのは最大92日分で、それより長い期間はトレンドで移動平均を確認できます。

パラメーター
  • start_date必須開始日(YYYY-MM-DD)
  • end_date必須終了日(YYYY-MM-DD)。開始日を含めて最大92日

こう話しかけてみましょう 「この1週間のサマリーを見せて」

表示インタラクティブUI

get_digest

1つの期間(昨日、今日のここまで、直近7日間または30日間)のまとめをインタラクティブなカードで表示します。カロリーと各栄養素の目標との比較、前の期間と比べたトレンド、水分と体重、食事内容または記録の習慣、そしてご自身の記録からのハイライトをまとめます。

パラメーター
  • period任意yesterday(既定)、today、last_7_days、last_30_daysのいずれか。期間はどちらも昨日までです。

こう話しかけてみましょう 「昨日はどうだった?」

記録

log_active_calories

運動で消費したエネルギーをキロカロリー単位で記録します。時計やフィットネスアプリが表示する値(多くは「アクティブカロリー」)を使います。摂取カロリーと並べて表示され、カロリー目標は変わりません。摂取カロリーに差し引かれるのは set_activity_credit で設定した割合だけで、各記録は登録時点の割合を保持します。

パラメーター
  • kcal必須消費エネルギー(キロカロリー)。1〜10,000 の整数。
  • logged_at任意活動した日時。省略すると現在時刻。日付、現地時刻、またはオフセット付きの完全な ISO 時刻。
  • notes任意任意の短いメモ(例:「朝のランニング」)。
  • idempotency_key任意任意のキー。再送しても同じ記録が二重に追加されないようにします。

こう話しかけてみましょう 「今朝のランニングで420アクティブカロリー消費した」

表示

get_active_calories

1日または期間のアクティブカロリー(運動で消費したエネルギー)を一覧します。各記録の現地時刻、kcal、摂取カロリーに算入された割合、メモ、ID に加え、日ごとの消費量と算入量の合計を含みます。日付を省略すると今日です。期間は最大31日です。

パラメーター
  • date任意1日の日付(YYYY-MM-DD)。これか start_date と end_date のどちらか一方を指定します(両方は不可)。
  • start_date任意期間の開始日(YYYY-MM-DD、含む)。
  • end_date任意期間の終了日(YYYY-MM-DD、含む)。

こう話しかけてみましょう 「今週はアクティブカロリーをどれくらい消費した?」

削除

delete_active_calories

誤って追加したアクティブカロリーの記録を削除します。摂取カロリーとカロリー目標には影響しません。

パラメーター
  • id必須削除するアクティブカロリー記録のUUID

こう話しかけてみましょう 「最後のアクティブカロリーの記録を削除して」

設定とアカウント

記録を正確に保つための設定と、データを自分で管理するための機能。

設定

set_meal_schedule

Set your daily meal cadence and calorie split (any ordered list of 1 to 8 slots, typically 2 to 5) plus an optional end-of-day wrap-up time. Used to split remaining calories across upcoming meals on the Today card and widgets.

パラメーター
  • slots任意Ordered meal slots with name, typical HH:MM time, and relative calorie share (normalized to 100%).
  • day_ends_at任意Optional HH:MM time when the Today card switches to Day wrapped up (defaults to 90 minutes after the last slot).
  • reset任意Clear the saved schedule back to automatic history inference or the default 3-meal 20/40/40 split.

こう話しかけてみましょう 「I eat 3 meals: breakfast at 8:30 (20%), lunch at 13:00 (40%), dinner at 19:00 (40%)」

表示

get_profile

現在の設定をまとめて確認できます。対象は、タイムゾーン(現地の日付と時刻も)、ウィジェットの言語、体重と長さの単位、チャット内ウィジェットの表示の有無、アルコール記録のオン/オフです。

こう話しかけてみましょう 「今の設定を教えて」

設定

set_timezone

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

こう話しかけてみましょう 「今ベルリンにいるから、タイムゾーンを設定して」

設定

set_language

チャット内ウィジェット(ダッシュボードやグラフ)の表示言語を設定します。AIが返答する言語は変わりません。

パラメーター
  • locale必須ISO 639-1コード(例:de、ja)。対応言語:英語、ドイツ語、スペイン語、フランス語、オランダ語、ポーランド語、イタリア語、ウクライナ語、日本語、トルコ語。

こう話しかけてみましょう 「ウィジェットをドイツ語で表示して」

表示

get_current_time

設定したタイムゾーンでの現在の日付と時刻、そしてUTCでの時刻を確認します。アシスタントに現在時刻を伝えないアプリもあるため、AIはこのツールで「今朝」や「今日」がいつを指すのかを、聞き返さずに判断します(タイムゾーンが未設定ならUTCになります)。

こう話しかけてみましょう 「こっちの時間で今何時?」

設定

set_widget_display

チャット内のビジュアルウィジェット(ダッシュボード、目標リング、トレンドグラフ)のオン/オフを切り替えます。オフにすると、同じツールがテキストとデータだけで応答します。デフォルトはオンで、変更は新しい会話から反映されます。詳細をあらかじめ展開した状態で開くか、折りたたんだ状態(デフォルト)で開くかも選べます。これは次のウィジェットから反映されます。

パラメーター
  • enabled任意trueでウィジェットを表示、falseでテキストのみで応答
  • expanded任意trueで詳細を展開した状態でウィジェットを開く、falseで折りたたんだ状態で開く

こう話しかけてみましょう 「ウィジェットをオフにして」

設定

set_alcohol_tracking

アルコール記録のオン/オフを切り替え、飲み物をUS標準ドリンクとUKユニットのどちらで数えるかを選びます。デフォルトはオフなので、使うにはオンにするよう頼む必要があります。再びオフにすると、食事・目標・進捗にアルコールが表示されなくなり、ファイルインポーターもファイルのアルコール列を読み込まなくなります。記録済みのデータは削除されず、CSVエクスポートにも引き続き含まれ、オンに戻せば再び表示されます。変更は次のメッセージから反映され、再起動などは必要ありません。

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

こう話しかけてみましょう 「お酒の記録を始めて。UKユニットで」

設定

set_activity_credit

アクティブカロリー(運動で消費したエネルギー)のうち、摂取カロリーに算入する割合を0〜100%で設定します。null を指定すると既定の100%に戻ります。今後登録する記録に適用され、既存の記録は登録時の割合を保持します。カロリー目標は変わりません。

パラメーター
  • percent必須0〜100の整数。null で既定の100に戻します。

こう話しかけてみましょう 「アクティブカロリーの50%を摂取カロリーに算入して」

削除

delete_account

Nutrition MCPのアカウントと、そこに保存されているあなたのデータをすべて完全に削除します。元に戻せないため、明示的な確認がない限りツールは何も実行しません。また、実行する前にユーザーに確認するよう、AIにも求めています。

こう話しかけてみましょう 「アカウントとデータを全部削除して」

トラブルシューティング

うまく動かないときは? ほとんどの問題はすぐに解決できます。

それでも解決しないときは? your@email.com

01コネクタが接続できない、または何度もサインインを求められる

コネクタを削除し、https://nutrition.liangjacky.com/mcpを正確に入力して追加し直してください。/mcpの部分も必要です。Claudeでは「カスタマイズ」→「コネクタ」を開き、Nutritionを切断してから接続し直します。ChatGPTでは「設定」→「アプリ」から操作します。以前と同じメールアドレスとパスワード、または同じGoogleアカウントでサインインしてください。データは接続ではなくアカウントに紐づいているため、再接続しても何も失われません。一度接続すれば、少なくとも90日に1回使っている限り接続は維持されます。動かなくなったときも、同じ手順で再接続すれば直ります。

02サインインページに{"error":"session_expired"}と表示される

サインインページの有効期限は10分で、アップデートでサーバーが再起動したときにもリセットされます。サインインページに戻って再読み込みするか、AIアプリから接続をやり直し、時間を空けずにサインインしてください。代わりにsession_mismatchと表示される場合は、サインインを始めたのとは別のブラウザで完了しようとしています。AIアプリからやり直し、同じブラウザで最後まで進めてください。

03サインインできない、またはパスワードを忘れた

すでにアカウントがある場合は「サインイン」を使ってください。メールアドレスかパスワードが違うときは「メールアドレスまたはパスワードが正しくありません」と表示され、新しいアカウントが作られることはありません。「アカウントを作成」を使うのは初回だけです。メールアドレスに入力ミスがないかも確認してください。「Googleで続行」でアカウントを作成した場合は、もう一度そのボタンを使ってください。パスワードを自分でリセットする機能はまだありません。アカウントのメールアドレスからyour@email.comにメールをいただければ、こちらでリセットします。

04再接続したら履歴が消えた

メールアドレスごとに別のアカウントになるため、別のメールアドレスでサインインすると、空のアカウントが新しく作られます。何も削除されてはいません。一度切断して、最初に使ったメールアドレスでサインインし直してください。どのアドレスだったかわからない場合は、your@email.comまでメールしてください。

05AIは返答するのに、何も記録されない

この会話でコネクタがオンになっているか確認してください(Claudeではメッセージ入力欄のツールメニューで確認できます)。そのうえで、「Nutritionに朝食を記録して」のように直接頼んでみてください。アプリからツールの使用許可を求められたら、許可してください。

06食事が違う日に表示される

日付はタイムゾーンを基準に区切られ、一度も設定していない場合はUTCが使われます。「タイムゾーンは何に設定されてる?」と聞き(get_profile)、間違っていれば「タイムゾーンをEurope/Berlinに設定して」と頼んでください(set_timezone)。これで、過去の分も含め、記録したものはすべて現地の日付でまとめられます。唯一の例外は、タイムゾーンが間違っていた間に時刻を指定して記録したものです。保存された時点の日時がそのまま残るため、1時間や1日ずれたままになることがあります。AIに正しい日付と時刻へ移すよう頼んでください(update_meal)。履歴をインポートする前にも、タイムゾーンを設定しておきましょう。インポートした食事は割り当てられた日時がそのまま残るため、タイムゾーンを変えた後で他のアプリのファイルをもう一度インポートすると、同じ食事が二重に追加されます。Nutrition MCPのエクスポートファイルは認識されるため、重複しません。

07テキストだけで、グラフやカードが表示されない

ビジュアルカードを表示するには、ClaudeやChatGPTのように、インタラクティブなMCP Appsパネルに対応したアプリが必要です。それ以外のクライアントでは、同じ情報がテキストで届きます。ウィジェットをオフにしていた場合は、オンに戻すよう頼んで(set_widget_display)、新しい会話を始めてください。開いているチャットは、再接続するまで以前の設定のままです。食事を記録した後の小さなカードは、1日の目標を設定するまで表示されません(set_nutrition_goals)。

08インポーターが開かない、または保存できないと表示される

インポーターパネルを使うには、インタラクティブなパネルを表示でき、ウィジェットがオンになっているアプリが必要です。「このホストでは、この画面から記録に書き込めません」と表示される場合や、パネルがまったく表示されない場合は、AIにファイルを直接インポートするよう頼んでください。CSVを添付するか貼り付ければ、AIがbulk_import_mealsを使います。このツールはすべての行をチェックして重複をスキップするため、間にタイムゾーンを変更していなければ再送しても安全です。最初のインポートの前に、タイムゾーンを設定しておきましょう。変更後に他のアプリのファイルを再インポートすると、同じ行がもう一度追加されます。インポーターパネルでアルコール列も取り込みたい場合は、先にアルコール記録をオンにしてください。オフの間、パネルはその列をスキップし、後から再インポートしてもその列は埋まりません。

09「Rate limit exceeded」または「Too many failed authentication attempts」と表示される

1つのアカウントにつき1分あたり60リクエストまで送信でき、ツール呼び出しは1回ごとに少なくとも1リクエストとして数えられます。メッセージに表示された秒数だけ待ってから続けてください。たくさんの食事をさかのぼって記録するときは、1件ずつ記録せずにインポーターを使ってください。サインインページは、ネットワークごとに1分あたり30リクエストまでです。同じネットワークから接続が20回連続で拒否されると(たいていは、切断済みの古いコネクタが再試行を続けているのが原因です)、そのネットワークからの接続は5分間停止され、繰り返すたびに停止時間は最長1時間まで延びます。古いコネクタを削除して追加し直せば、再試行は止まります。

10バーコードが見つからない、または数値がおかしい

バーコードのデータは、コミュニティが運営するデータベースOpen Food Factsから取得しているため、登録されていない商品や、情報が古い商品もあります。バーコードの下の8〜14桁の数字がすべて正しく読み取られているか確認してください。商品が見つからなくても、AIが商品名や栄養成分表示の写真から推定でき、どの数値も後から修正できます。openfoodfacts.orgに商品を登録すると、ほかの人の役にも立ちます。Open Food Factsにはカフェインのデータがないため、カフェインは表示ラベルや一般的な含有量をもとにします。

11AI が「USDA data is unavailable until …」と表示する

一般的な食品の検索は、このサーバーのすべての利用者が共有する1つの API キーで USDA FoodData Central に送られ、USDA はそのキーが1時間に送れるリクエスト数を制限しています。サーバーは次の3つの場合に USDA の呼び出しを止めます。USDA が上限に達したと報告したとき(その場合、呼び出しは60分間停止します)、キーの残りの時間あたり枠がほぼ使い切られているとき、そして直近1時間に USDA への照会を30回行ったとき。メッセージには、USDA が再び利用可能になる時刻が、プロフィールのタイムゾーンで示されます(未設定の場合は UTC)。検索結果は保存されないため、検索はその時刻まで待機します。直近30日以内に照会された食品はサーバーに保存されており、停止中も利用できます。保存済みの食品を取得しても、1時間あたり30回の枠は消費されません。USDA の名称は英語のみのため、検索は英語で行ってください。パッケージ商品は影響を受けません。バーコードで検索してください。

12昨日の分がまだApple Healthにない

Apple Healthとの同期は、終わった日だけを送ります。1日はタイムゾーンで翌朝05:00に締まるため、昨日の分は今日の05:00以降の最初の同期で届き、今日の分がヘルスケアに表示されるのは明日です。同期は、ショートカットのオートメーションが動いたとき(ヘルスケアAppを開く、アラームを止める)か、ショートカットAppでNutrition MCP Healthを実行してSync nowを選んだときに行われます。同期しなかった朝の分は自動で取り戻されます。毎回の同期で直近7日間をさかのぼるからです。日付はプロフィールのタイムゾーン(get_profile)、一度も設定していない場合は接続時にiPhoneが伝えたタイムゾーンで区切られます(食事が違う日に表示される)。接続より前の日は、接続時に最大7日前までさかのぼることを選んだ場合にだけ送られます。

13Apple Healthの数値がチャットより多い

Apple Healthは値を足すことはできても、すでにある値を減らすことはできません。送信済みの日に食事を追加すると、その日が直近7日間に入っている限り、12:01、12:02…の小さな追加エントリとして届きます。日が送信された後に食事を削除したり減らしたりすると、ヘルスケアの値は高いまま残り、ショートカットがその差を通知します。直すには、ヘルスケアAppでブラウズ → 栄養を開き、該当する項目ですべてのデータを表示をタップし、その日の「ショートカット」からのエントリを削除して、正しい合計を手入力してください。“ショートカット”からのすべてのデータを削除は使わないでください。ほかのショートカットが記録したデータも消えます。毎日が2倍に見える場合は、別のAppも同じ項目を書き込んでいて、ヘルスケアが両方を合計しています。ヘルスケアAppの共有 → Appでどちらかをオフにしてください。

14Apple Healthとの同期が止まった

ショートカットAppでNutrition MCP Healthを手動で実行してください。何が問題かを表示します。もう一度接続するよう求められたら、接続は終了しています(同期のないまま90日たった、接続から365日たった、またはDisconnectを選んだ)。実行して、開いたページでAIアプリと同じアカウントでサインインし、30分以内に完了してください。手動なら同期するのに自動では動かない場合は、ショートカットAppのオートメーションタブでそのオートメーションがオンで、すぐに実行になっているか確認してください。ある日がApple Healthに届かなかったと通知された場合は、ヘルスケアAppの共有 → App → ショートカットで、すべての栄養項目への書き込みを許可してから、もう一度実行してください。新しいiPhoneを接続すると、古いiPhoneの接続は置き換えられます。

16アカウントを削除するには?

AIにNutrition MCPのアカウントを削除するよう頼んでください(delete_account)。AIが確認を求め、確認すると食事、保存した食事、水分、体重、体の計測値、目標、設定、AIアプリがどのツールを使ったかの記録、エクスポートファイル(ある場合)、サインイン情報、そしてアカウント自体が完全に削除されます。元に戻せないため、コピーを残したい場合は先にデータをエクスポートしてください。そのあと、アプリからコネクタを削除してください。後で同じメールアドレスでサインインし直すと、新しい空のアカウントが作成されます。

17バグやセキュリティの問題を報告するには?

バグはGitHub Issuesで報告してください。使っているアプリ(Claude、ChatGPTなど)、何を頼んだか、何が起きたか、おおよその日時を書いてください。パスワードは絶対に書かないでください。セキュリティの問題は公開の場では報告せず、セキュリティポリシーに記載のとおり、GitHubの非公開脆弱性報告またはメールで非公開で報告してください。その他のお問い合わせは、your@email.comまでメールでどうぞ。