Wellness Nourish について
Wellness Nourishは、AIエージェントやMCPクライアント向けのローカル優先型栄養MCPサーバーです。食品検索、食事推定、摂取記録に対応し、記録はローカルに保存され、オフラインデモも利用できます。
主な機能
- 01食品検索とバーコード照合
- 02写真を使った食事推定
- 03摂取量と水分の記録
- 04目標、サマリー、食事提案
- 05ローカル保存とオフラインデモ
活用シーン
- 01食品名やバーコードで栄養を検索
- 02食品写真から食事を推定
- 03毎日の食事と水分を記録
- 04目標に沿って日次サマリーを確認
MCP 対応
stdioまたはステートレスなStreamable HTTPで、MCPクライアントに栄養関連ツールを提供します。摂取量、水分、目標などの変更には、ユーザーの明示的な保存意思が必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
46掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| client | enum | いいえ | claude | codex | cursor | windsurf | hermes | openclaw | generic |
| response_format | enum | いいえ | json | markdown |
詳細
Wellness Nourish
ローカル優先の栄養管理 MCP — 食品検索、バーコード検索、摂取記録、水分補給。OAuth なしで動作します。
ローカル優先の MCP サーバー — トークンがマシンの外に出ることはありません。
📈 npm で公開され、AI エージェントや MCP クライアントに利用されています — 現在の数値は上のダウンロード数バッジをご覧ください。
Nourish がエージェントに役立ったら、このリポジトリに ⭐ を付けていただくと、ほかの AI 開発者にも見つけてもらいやすくなります。
0.7.1 の新機能: オフラインのフィクスチャデモが公開済みの npm パッケージから動作するようになりました(フィクスチャを同梱し、パッケージルートからパスを解決)。0.7.0: ブラジルの食品(cafezinho、feijão、concha、churrasco 風の食事)に対応する TACO 4 の食事推定機能と Smithery インストールに対応しました。オフラインデモ:
NOURISH_FIXTURE_MODE=1 npx -y wellness-nourish search banana。詳細:CHANGELOG.md · 評価:docs/evals/pt-br-meal-estimator.json(52 件)。
公開実績: Nourish は、ダウンロード数、スター数、次のアクションの優先順位とともに、Delx のオープンソース成長スナップショットに掲載されています。セットアップの時間短縮に役立った場合は、このリポジトリにスターを付けて、ほかのエージェント開発者がローカルファーストの栄養管理方法をすぐに見つけられるようご協力ください。
HTTP(v2 ステートレス)
デフォルトは stdio です。オプションの Streamable HTTP は、セッション ID なし、JSON レスポンス、ループバック接続のみです:
npx -y wellness-nourish --http
# GET http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp (sessionless)
環境変数:NOURISH_MCP_HOST、NOURISH_MCP_PORT、NOURISH_MCP_TRANSPORT=http。
AI エージェント向けのローカルファーストな栄養管理 MCP — 食品検索、バーコード検索、写真を活用した食事推定、摂取記録、水分補給、目標設定、コーチ形式のワークフローに対応します。OAuth もホスト型アカウントも不要です。
まずはこちら
- コネクターを 1 つインストール —
npx -y wellness-nourish setup --client claude - 次の環境で実行:Claude · Cursor · ChatGPT · Hermes · OpenClaw — クライアントの使用例をご覧ください。
- ローカルファースト — トークンや食事記録が端末の外に出ることはありません(プライバシー)。
- どのコネクターを使えばよいですか? — 利用ガイドをご覧ください。
クイックスタート(60 秒)
npx -y [email protected] doctor
npx -y [email protected] search banana
npx -y [email protected] barcode 0000000000000
npx -y [email protected] log --preview "2 ovos, banana e café preto"
doctor は準備状況を確認し、search/barcode は食品データプロバイダーに問い合わせます。また、log --preview は何も記録せずに食事をローカルで推定します。
ご協力いただけること
| アクション | リンク |
|---|---|
| 役に立ったらスターを付ける | スターを付けたユーザー |
| ドキュメントの GFI — 2 分で最初の食事を記録 | #25 |
| 実際のバグや pt-BR 食品の未登録情報を報告 | イシュー |
| ウェルネスの総合ハブ | delx-wellness |
秘密情報不要のデモ(オフライン、API キー不要)
NOURISH_FIXTURE_MODE=1 を指定すると、USDA や Open Food Facts に問い合わせず、同梱の fixtures/ を使用します。ネットワークアクセスもキーも不要で、すべてのレスポンスの正確な形式を確認できます:
$ NOURISH_FIXTURE_MODE=1 wellness-nourish search banana
Bananas, raw usda 89 kcal/100g
BANANA usda 312 kcal/100g
エージェントで試す
すぐにコピーして使える 3 つのプロンプトです。いずれも既存のツールで実行できます:
- 「卵 2 個、バナナ 1 本、ブラックコーヒーのカロリーとタンパク質を推定してください。」→
nourish_estimate_meal - 「バーコード 737628064502 を調べて、何の商品か教えてください。」→
nourish_lookup_barcode - 「今日の目標を踏まえて、次に何を食べるのがおすすめですか?」→
nourish_daily_coach/nourish_suggest_next_meal
摂取記録、水分、目標、当日の記録消去など、データを変更するツールは、ユーザーが明示的に保存を指示しない限り実行されません。エージェントが explicit_user_intent: true を渡すまで、USER_ACTION_REQUIRED を返します。
ツール
Nourish は、食品検索、バーコード検索(テキスト+画像)、写真を使った食事の推定、摂取記録、水分補給、目標、エクスポート、日次/週次サマリー、個人の食事メモリー、コーチ形式のワークフローを、stdio(デフォルト)または Streamable HTTP(POST /mcp)経由で提供します。
- CLI 全機能(20 以上のコマンド)、インストール、クライアント設定、ChatGPT ダッシュボード →
docs/cli.md - Hermes / Telegram の個人向けセットアップ(10 ステップの手順) →
docs/telegram.md - データプロバイダーと帰属表示(USDA、Open Food Facts、ZXing) →
docs/providers.md - pt-BR 食事推定評価セット(52 個の例) →
docs/evals/pt-br-meal-estimator.json - 再現可能な Telegram / Hermes デモのトランスクリプト →
docs/telegram-demo-transcript.json
食品写真の判断ツリー
エージェントは、抽出できる最も確かな手がかりに基づいて、Telegram / Hermes / OpenClaw の食品写真を適切に振り分けてください。
- バーコードが見えており、画像データを利用できる場合:
nourish_lookup_barcode_imageを呼び出します。 - バーコードがぼやけている場合、または商品が見つからない場合:鮮明なバーコードの数字を尋ねるか、
barcode_observationに加えて OCR /食事の手がかりがあればそれも指定して、nourish_analyze_food_imageを呼び出します。 - 栄養成分表示が読み取れる場合:ラベルを OCR し、
product_nameとnutrition_label_textを指定してnourish_analyze_food_imageを呼び出します。 - 皿に盛られた食品または包装されていない食品の場合:見えている食品や分量を説明し、
detected_itemsまたはimage_descriptionを指定してnourish_analyze_food_imageを呼び出します。 - ユーザーが商品または食事、分量、保存する意思を確認するまでは、画像の応答から記録してはいけません。
画像ツールは、次の入力形式のいずれか 1 つだけを受け付けます。
{ "image_path": "/tmp/telegram-food-photo.jpg" }
{ "image_base64": "<base64 image bytes>", "image_mime_type": "image/jpeg" }
{ "image_data_uri": "data:image/jpeg;base64,<base64 image bytes>" }
バーコードのデコードに失敗した場合、応答には fallback と next_actions が含まれます。これにより、エージェントはユーザーに数字の入力を求めるか、栄養成分表示を OCR するか、食品を勝手に作り上げることなく写真を食事として振り分けることができます。
上の画面は、一時的なローカルディレクトリを使い、フィクスチャモードで実際の MCP 実行から生成されています。
npm run demo:capture
コミット済みのトランスクリプトでは、正確なツール呼び出しの順序が示されています:nourish_estimate_meal → ユーザーの確認 → nourish_log_intake → nourish_daily_summary。
プライバシーとオフラインでの動作
摂取、水分補給、目標のデータは ~/.wellness-nourish/ にローカル保存されます(NOURISH_LOCAL_DIR で変更できます)。コネクターはホストされたアカウントを必要とせず、ローカルの摂取記録を Delx Wellness に送信しません。プロバイダーへの問い合わせでは USDA FoodData Central または Open Food Facts に接続する場合があります。ただし、NOURISH_FIXTURE_MODE=1 を設定すると、同梱のフィクスチャを使い、すべての処理をオフラインで行います。
エージェントは、API キー、トークン、健康データの生エクスポート、個人的な食事記録をチャットに貼り付けるようユーザーに求めてはいけません。シークレットは環境変数またはローカルファイルで設定してください。詳細は docs/providers.md をご覧ください。
エージェントのデモ全編を見る →
再現可能な 1 回の実行で、Nourish が他のコネクターと連携する様子をご覧ください。
npx -y delx-living-body demo
中心となる質問:「今日はハードなトレーニングをしてもよいですか?」 — このデモでは、ウェアラブル端末の回復シグナルと栄養に関する情報を組み合わせて回答します。これは Delx Wellness スタック全体を実証する、共有可能で再現性のある資料です。
関連項目
Delx Wellness のコネクターライブラリ全体:
| プロバイダー | パッケージ | リポジトリ |
|---|---|---|
| WHOOP | whoop-mcp-unofficial | whoop-mcp |
| Oura | oura-mcp-unofficial | ouramcp |
| Garmin | garmin-mcp-unofficial | garmin-mcp |
| Strava | strava-mcp-unofficial | strava-mcp |
| Fitbit | fitbit-mcp-unofficial | fitbitmcp |
| Google Health | google-health-mcp-unofficial | google-health-mcp |
| Withings | withings-mcp-unofficial | withingsmcp |
| Apple Health | apple-health-mcp-unofficial | apple-health-mcp |
| Samsung Health | samsung-health-mcp-unofficial | samsung-health-mcp |
| Polar | polar-mcp-unofficial | polarmcp |
| Nourish(栄養) | wellness-nourish | wellness-nourish |
Hermes のワンコマンドセットアップ — 上記すべてのコネクターに加え、ウェルネススキルとオンボーディングを事前設定します:delx-wellness-hermes。
医療上の助言ではありません
栄養の推定値は概算であり、個人的な記録およびエージェントのワークフローでの利用を目的としています。診断、治療、医療上の助言ではありません。重要な栄養に関する判断は、資格を持つ専門家に確認してください。
非公式です。 USDA、Open Food Facts、その他の第三者との提携、承認、後援関係はありません。すべての商標は、それぞれの所有者に帰属します。
📧 お問い合わせとサポート
- 📨 [email protected] — 一般的な質問、インテグレーションのサポート、パートナーシップ
- 🤝 行動規範 — CODE_OF_CONDUCT.md
- 🐛 バグ報告/機能リクエスト — GitHub Issues
- 🐦 最新情報 — X の @delx369
- 🌐 サイト — wellness.delx.ai
2 分で最初の食事を記録: docs/first-meal-2-minutes.md
ウェアラブルのコンテキストフィールド(捏造なし): docs/wearable-context-schema.md
スキルまたは MCP
同じパッケージから、2 通りの方法で利用できます。MCP は stdio/HTTP 上にツールを登録します。スキルを使えば、クライアントに MCP がない場合でも、CLI 経由で同じツールを操作できます:
npx -y wellness-nourish call nourish_connection_status --json '{}'
skill/SKILL.md をエージェントのスキルディレクトリにコピーしてください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。