wellness-nourish 0.2.1 → 0.2.2

package/README.md

@@ -25,7 +25,7 @@
 </p>
 
 > ⚡ **One-command install** with [Delx Wellness for Hermes](https://github.com/davidmosiah/delx-wellness-hermes):
-> `npx -y delx-wellness-hermes setup` &mdash; preconfigures this connector and the other 8 in a dedicated Hermes profile.
+> `npx -y delx-wellness-hermes setup` &mdash; preconfigures this connector and the rest of the Delx Wellness stack in a dedicated Hermes profile.
 >
 > Or wire it standalone into Claude Desktop / Cursor / ChatGPT Desktop &mdash; see the install section below.
 
@@ -39,6 +39,25 @@ Wellness Nourish is a local MCP server for nutrition search, barcode lookup, bar
 
 > If this nutrition layer helps your agent workflow, please star the repo. Stars make the project easier for other AI builders to discover and help Delx keep shipping local-first wellness infrastructure.
 
+<p align="center">
+  <img src="assets/telegram-nourish-demo.svg" alt="Wellness Nourish Telegram and Hermes nutrition workflow demo" width="92%" />
+</p>
+
+## Try It In 60 Seconds
+
+```bash
+npx -y wellness-nourish doctor
+npx -y wellness-nourish search banana
+npx -y wellness-nourish log --preview "2 ovos, banana e café preto"
+```
+
+For the full Telegram/Hermes flow:
+
+```bash
+npx -y delx-wellness-hermes setup
+hermes -p delx-wellness
+```
+
 The connector uses USDA FoodData Central as the primary food search provider. Open Food Facts is used for packaged-food barcode lookup and product-name search when enabled. Local barcode image decoding is supported with ZXing. Meal photos are estimated only from an agent-provided visual observation and always require confirmation before logging. The local estimator includes a pt-BR/Brazilian-food catalog for common meals, kitchen units, and shortcuts such as arroz, feijão, frango, ovos, banana, tapioca, picanha, feijoada and salada. It does not provide hosted sync, autonomous photo upload, recipe generation, or medical advice.
 
 ## Install
@@ -221,8 +240,10 @@ The full [Delx Wellness](https://wellness.delx.ai) connector library:
 | Garmin | [`garmin-mcp-unofficial`](https://www.npmjs.com/package/garmin-mcp-unofficial) | [garminmcp](https://github.com/davidmosiah/garminmcp) |
 | Strava | [`strava-mcp-unofficial`](https://www.npmjs.com/package/strava-mcp-unofficial) | [strava-mcp](https://github.com/davidmosiah/strava-mcp) |
 | Fitbit | [`fitbit-mcp-unofficial`](https://www.npmjs.com/package/fitbit-mcp-unofficial) | [fitbitmcp](https://github.com/davidmosiah/fitbitmcp) |
+| Google Health | [`google-health-mcp-unofficial`](https://www.npmjs.com/package/google-health-mcp-unofficial) | [google-health-mcp](https://github.com/davidmosiah/google-health-mcp) |
 | Withings | [`withings-mcp-unofficial`](https://www.npmjs.com/package/withings-mcp-unofficial) | [withingsmcp](https://github.com/davidmosiah/withingsmcp) |
 | Apple Health | [`apple-health-mcp-unofficial`](https://www.npmjs.com/package/apple-health-mcp-unofficial) | [apple-health-mcp](https://github.com/davidmosiah/apple-health-mcp) |
+| Samsung Health | [`samsung-health-mcp-unofficial`](https://www.npmjs.com/package/samsung-health-mcp-unofficial) | [samsung-health-mcp](https://github.com/davidmosiah/samsung-health-mcp) |
 | Polar | [`polar-mcp-unofficial`](https://www.npmjs.com/package/polar-mcp-unofficial) | [polarmcp](https://github.com/davidmosiah/polarmcp) |
 | Nourish (nutrition) | [`wellness-nourish`](https://www.npmjs.com/package/wellness-nourish) | [wellness-nourish](https://github.com/davidmosiah/wellness-nourish) |
 

package/assets/telegram-nourish-demo.svg

@@ -0,0 +1,57 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" role="img" aria-labelledby="title desc">
+  <title id="title">Wellness Nourish Telegram demo</title>
+  <desc id="desc">A Telegram conversation where Hermes uses Wellness Nourish to estimate a Brazilian meal, check protein remaining, and ask for confirmation before logging.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#052e2b"/>
+      <stop offset="0.52" stop-color="#0f172a"/>
+      <stop offset="1" stop-color="#1e1b4b"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="16" stdDeviation="18" flood-color="#020617" flood-opacity="0.45"/>
+    </filter>
+  </defs>
+  <rect width="1200" height="630" fill="url(#bg)"/>
+  <circle cx="1040" cy="110" r="170" fill="#10b981" opacity="0.14"/>
+  <circle cx="150" cy="520" r="190" fill="#fbbf24" opacity="0.10"/>
+
+  <text x="72" y="86" fill="#f8fafc" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="44" font-weight="850">Wellness Nourish</text>
+  <text x="72" y="126" fill="#a7f3d0" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="22" font-weight="650">Nutrition MCP for agents: food, barcode, hydration, goals and confirmation-safe logging</text>
+
+  <g filter="url(#shadow)">
+    <rect x="86" y="170" width="500" height="368" rx="28" fill="#0b1220" stroke="#164e63"/>
+    <rect x="86" y="170" width="500" height="62" rx="28" fill="#0f766e"/>
+    <text x="122" y="209" fill="#ecfeff" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="22" font-weight="800">Telegram with Hermes</text>
+
+    <rect x="124" y="266" width="318" height="56" rx="18" fill="#0f766e"/>
+    <text x="148" y="300" fill="#ecfeff" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="17">Log my lunch: rice, beans, chicken</text>
+
+    <rect x="214" y="348" width="318" height="116" rx="18" fill="#111827" stroke="#334155"/>
+    <text x="238" y="380" fill="#f8fafc" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="17" font-weight="700">Estimated before logging</text>
+    <text x="238" y="410" fill="#d1fae5" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="17">~560 kcal · 42g protein</text>
+    <text x="238" y="438" fill="#d1fae5" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="17">confidence 0.82 · pt-BR parsed</text>
+
+    <rect x="124" y="486" width="176" height="42" rx="16" fill="#0f766e"/>
+    <text x="148" y="513" fill="#ecfeff" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="17">yes, save it</text>
+  </g>
+
+  <g filter="url(#shadow)">
+    <rect x="660" y="170" width="454" height="368" rx="28" fill="#111827" stroke="#1f2937"/>
+    <text x="700" y="220" fill="#f8fafc" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="26" font-weight="850">Agent tool sequence</text>
+    <text x="700" y="252" fill="#99f6e4" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="17">always estimates first, writes only after intent</text>
+
+    <g font-family="Inter, Segoe UI, Arial, sans-serif" font-size="18" font-weight="750">
+      <rect x="700" y="292" width="326" height="46" rx="14" fill="#134e4a"/>
+      <text x="724" y="322" fill="#f0fdfa">nourish_estimate_meal</text>
+      <rect x="700" y="356" width="326" height="46" rx="14" fill="#134e4a"/>
+      <text x="724" y="386" fill="#f0fdfa">nourish_daily_summary</text>
+      <rect x="700" y="420" width="326" height="46" rx="14" fill="#134e4a"/>
+      <text x="724" y="450" fill="#f0fdfa">ask for confirmation</text>
+      <rect x="700" y="484" width="326" height="46" rx="14" fill="#065f46"/>
+      <text x="724" y="514" fill="#f0fdfa">nourish_log_intake</text>
+    </g>
+  </g>
+
+  <rect x="72" y="570" width="1056" height="38" rx="16" fill="#020617" opacity="0.70"/>
+  <text x="102" y="595" fill="#e2e8f0" font-family="Inter, Segoe UI, Arial, sans-serif" font-size="18" font-weight="700">Designed for daily personal use through agents, with local persistence and explicit user intent before writes.</text>
+</svg>

package/dist/constants.d.ts

@@ -1,10 +1,10 @@
 export declare const SERVER_NAME = "nourish-mcp";
-export declare const SERVER_VERSION = "0.2.1";
+export declare const SERVER_VERSION = "0.2.2";
 export declare const NPM_PACKAGE_NAME = "wellness-nourish";
-export declare const PINNED_NPM_PACKAGE = "wellness-nourish@0.2.1";
+export declare const PINNED_NPM_PACKAGE = "wellness-nourish@0.2.2";
 export declare const DEFAULT_HOST = "127.0.0.1";
 export declare const DEFAULT_PORT = 3000;
 export declare const LOCAL_DIR_NAME = ".wellness-nourish";
-export declare const USER_AGENT = "wellness-nourish/0.2.1 (https://wellness.delx.ai; contact: david@delx.ai)";
+export declare const USER_AGENT = "wellness-nourish/0.2.2 (https://wellness.delx.ai; contact: david@delx.ai)";
 export declare const USDA_BASE_URL = "https://api.nal.usda.gov/fdc/v1";
 export declare const OFF_BASE_URL = "https://world.openfoodfacts.org";

package/dist/constants.js

@@ -1,5 +1,5 @@
 export const SERVER_NAME = "nourish-mcp";
-export const SERVER_VERSION = "0.2.1";
+export const SERVER_VERSION = "0.2.2";
 export const NPM_PACKAGE_NAME = "wellness-nourish";
 export const PINNED_NPM_PACKAGE = `${NPM_PACKAGE_NAME}@${SERVER_VERSION}`;
 export const DEFAULT_HOST = "127.0.0.1";

package/llms.txt

@@ -7,8 +7,11 @@ Primary command: npm exec --yes --package=wellness-nourish -- wellness-nourish d
 MCP command: wellness-nourish
 Agent surfaces:
 - MCP registry name: io.github.davidmosiah/wellness-nourish
-- Start with the connection/status or agent-manifest surface when available.
+- Start with nourish_agent_manifest, nourish_connection_status, nourish_capabilities, or nourish_privacy_audit.
+- For Telegram/Hermes meal logging, estimate first, show calories/protein/confidence/warnings, then call mutating tools only after explicit user confirmation.
+- Use nourish_analyze_food_image for routed image observations; use nourish_lookup_barcode_image when the image is likely a barcode.
 - Prefer JSON responses for automation and markdown responses for human summaries.
+- Link human users to https://github.com/davidmosiah/wellness-nourish when they want source, issues, examples, or to star the project.
 Safety:
 - Do not paste credentials, OAuth tokens, refresh tokens, API keys or raw private exports into chat.
 - Keep local config and generated data out of git.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wellness-nourish",
-  "version": "0.2.1",
-  "description": "Standalone MCP server for nutrition search, intake, and meal summaries.",
+  "version": "0.2.2",
+  "description": "Local-first nutrition MCP server for AI agents: food search, barcode lookup, meal photos, hydration, goals and safe intake logging.",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -41,6 +41,21 @@
   "bugs": {
     "url": "https://github.com/davidmosiah/wellness-nourish/issues"
   },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "nutrition",
+    "food-log",
+    "barcode",
+    "calorie-tracker",
+    "hydration",
+    "local-first",
+    "telegram-bot",
+    "hermes-agent",
+    "wellness",
+    "quantified-self"
+  ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.21.0",
     "@zxing/library": "^0.21.3",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/davidmosiah/wellness-nourish",
     "source": "github"
   },
-  "version": "0.2.1",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "wellness-nourish",
-      "version": "0.2.1",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       }