nutritionix-mcp 1.0.0

package/README.md

@@ -0,0 +1,28 @@
+# Nutritionix MCP
+
+MCP server for Nutritionix: food search, nutrients. Needs free app keys.
+
+Pairs well with `spoonacular-mcp`, `themealdb-mcp`, and `open-food-facts-mcp`.
+
+## Setup
+
+Get keys at https://developer.nutritionix.com/ (free), then:
+
+```bash
+export NUTRITIONIX_APP_ID=your_id
+export NUTRITIONIX_API_KEY=your_key
+npm install
+npm run build
+node dist/index.js
+```
+
+The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code, MCP Inspector, or another compatible MCP client.
+
+## Tools at a glance
+
+- `search_foods`: Calories and macros.
+- `analyze_meal`: Nutrients for free-text meals with totals.
+
+## Limits and privacy
+
+This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. Keys stay local and go only to Nutritionix. Read-only.

package/dist/api.d.ts

@@ -0,0 +1,13 @@
+export declare class NutritionixError extends Error {
+}
+export interface Food {
+    name: string;
+    calories?: number;
+    protein?: number;
+    fat?: number;
+    carbs?: number;
+    serving?: string;
+}
+export declare function searchFoods(query: string, limit?: number): Promise<Food[]>;
+export declare function analyzeMeal(text: string): Promise<Food[]>;
+export declare function formatFood(f: Food, index?: number): string;

package/dist/api.js

@@ -0,0 +1,81 @@
+/**
+ * Nutritionix API v2 client. Needs NUTRITIONIX_APP_ID + NUTRITIONIX_API_KEY
+ * (free at https://developer.nutritionix.com/).
+ * Docs: https://developer.nutritionix.com/docs/v2
+ */
+const BASE = "https://trackapi.nutritionix.com/v2";
+export class NutritionixError extends Error {
+}
+function headers(extra = {}) {
+    const id = process.env.NUTRITIONIX_APP_ID;
+    const key = process.env.NUTRITIONIX_API_KEY;
+    if (!id || !key)
+        throw new NutritionixError("Set NUTRITIONIX_APP_ID and NUTRITIONIX_API_KEY first (free at developer.nutritionix.com).");
+    return { "User-Agent": "nutritionix-mcp/1.0", Accept: "application/json", "x-app-id": id, "x-app-key": key, ...extra };
+}
+async function getJson(path) {
+    const res = await fetch(`${BASE}${path}`, {
+        headers: headers(),
+        signal: AbortSignal.timeout(20000),
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new NutritionixError("Nutritionix refused (401/403). Check app id and key.");
+    if (res.status === 404)
+        throw new NutritionixError("Not found.");
+    if (!res.ok)
+        throw new NutritionixError(`Nutritionix error ${res.status}`);
+    return (await res.json());
+}
+async function postJson(path, body) {
+    const res = await fetch(`${BASE}${path}`, {
+        method: "POST",
+        headers: headers({ "Content-Type": "application/json" }),
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(20000),
+    });
+    if (res.status === 401 || res.status === 403)
+        throw new NutritionixError("Nutritionix refused (401/403). Check app id and key.");
+    if (!res.ok)
+        throw new NutritionixError(`Nutritionix error ${res.status}`);
+    return (await res.json());
+}
+export async function searchFoods(query, limit = 5) {
+    if (!query.trim())
+        throw new NutritionixError("Query is empty.");
+    const data = await getJson(`/search/instant?query=${encodeURIComponent(query.trim())}`);
+    const branded = Array.isArray(data.branded) ? data.branded : [];
+    const common = Array.isArray(data.common) ? data.common : [];
+    const out = [];
+    for (const f of common.slice(0, limit))
+        out.push({ name: String(f.food_name ?? "?") });
+    for (const f of branded.slice(0, Math.max(limit - out.length, 0))) {
+        out.push({
+            name: String(f.food_name ?? "?"),
+            calories: f.nf_calories,
+            protein: f.nf_protein,
+            fat: f.nf_total_fat,
+            carbs: f.nf_total_carbohydrate,
+            serving: f.serving_unit ? `${f.serving_qty ?? 1} ${f.serving_unit}` : undefined,
+        });
+    }
+    return out.slice(0, limit);
+}
+export async function analyzeMeal(text) {
+    if (!text.trim())
+        throw new NutritionixError("Text is empty.");
+    const data = await postJson("/natural/nutrients", { query: text.trim() });
+    const rows = Array.isArray(data.foods) ? data.foods : [];
+    return rows.slice(0, 10).map((f) => ({
+        name: String(f.food_name ?? "?"),
+        calories: f.nf_calories,
+        protein: f.nf_protein,
+        fat: f.nf_total_fat,
+        carbs: f.nf_total_carbohydrate,
+        serving: f.serving_unit ? `${f.serving_qty ?? 1} ${f.serving_unit}` : undefined,
+    }));
+}
+export function formatFood(f, index) {
+    const prefix = index !== undefined ? `${index + 1}. ` : "";
+    const macros = [f.calories !== undefined ? `${f.calories} kcal` : "", f.protein !== undefined ? `P ${f.protein}g` : "", f.fat !== undefined ? `F ${f.fat}g` : "", f.carbs !== undefined ? `C ${f.carbs}g` : ""].filter(Boolean).join(" · ");
+    return `${prefix}${f.name}${macros ? ` — ${macros}` : ""}${f.serving ? ` (${f.serving})` : ""}`;
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,58 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { analyzeMeal, formatFood, NutritionixError, searchFoods } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+export function createServer() {
+    const server = new McpServer({
+        name: "nutritionix-mcp",
+        version: "1.0.0",
+    });
+    server.registerTool("search_foods", {
+        title: "Search foods",
+        description: "Foods by name with calories and macros where known.",
+        inputSchema: z.object({
+            query: z.string().describe("Food, e.g. 'banana', 'big mac'"),
+            limit: z.number().int().min(1).max(20).default(5),
+        }),
+        annotations: READ_ONLY,
+    }, async ({ query, limit }) => {
+        try {
+            const rows = await searchFoods(query, limit);
+            if (rows.length === 0)
+                return text(`No foods for "${query}".`);
+            return text(rows.map((f, i) => formatFood(f, i)).join("\n"));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("analyze_meal", {
+        title: "Analyze meal",
+        description: "Nutrients for free-text meal descriptions like '2 eggs and toast'.",
+        inputSchema: z.object({
+            text: z.string().describe("Meal description"),
+        }),
+        annotations: READ_ONLY,
+    }, async ({ text: meal }) => {
+        try {
+            const rows = await analyzeMeal(meal);
+            if (rows.length === 0)
+                return text("Nothing recognized.");
+            const total = rows.reduce((n, f) => n + (f.calories ?? 0), 0);
+            return text(`${rows.map((f, i) => formatFood(f, i)).join("\n")}\n\nTotal: ${Math.round(total)} kcal`);
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    return server;
+}
+function errorMessage(e) {
+    if (e instanceof NutritionixError)
+        return `Error: ${e.message}`;
+    if (e instanceof Error)
+        return `Error: ${e.message}`;
+    return `Error: ${String(e)}`;
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "nutritionix-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Nutritionix: food search, nutrients. Needs free app keys.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/nutritionix-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/awesome-mcps.git"
+  },
+  "bin": {
+    "nutritionix-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "rm -rf dist && tsc -p tsconfig.json && node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "nutritionix",
+    "nutrition",
+    "api"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}