formlab-mcp 0.6.7 → 0.6.9

package/README.md

@@ -145,7 +145,7 @@ Or for local-dev (from the repo):
 }
 ```
 
-Restart Claude Desktop. You should see a hammer icon indicating tools are available, and FormLab's 33 tools become callable in any conversation.
+Restart Claude Desktop. You should see a hammer icon indicating tools are available, and FormLab's 34 tools become callable in any conversation.
 
 ## Wire it up to Claude Code
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formlab-mcp",
-  "version": "0.6.7",
+  "version": "0.6.9",
   "mcpName": "io.github.juliu1980/formlab-mcp",
   "description": "Read-only Model Context Protocol server for FormLab — lets Claude (and other MCP clients) read and analyze your FormLab data, from a local export file OR your live cloud workspace.",
   "type": "module",

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.juliu1980/formlab-mcp",
   "description": "Read-only MCP for FormLab — let Claude query your formulation lab. Free reads a local export; Pro connects to your live cloud workspace with a dedicated read-only token.",
-  "version": "0.6.7",
+  "version": "0.6.9",
   "websiteUrl": "https://formvix.com/mcp",
   "repository": {
     "url": "https://github.com/juliu1980/FormLab",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "formlab-mcp",
-      "version": "0.6.7",
+      "version": "0.6.9",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/tools/analytics.js

@@ -612,7 +612,7 @@ const list_doe_designs = {
 const get_doe_design = {
   definition: {
     name: 'get_doe_design',
-    description: 'Get one saved DOE design in full: factors and ranges, constraints, the model it was optimised for, generation settings (run budget, replicates, centre points, seed), D-efficiency, and the complete run matrix with the formulation each run became. Everything needed to reproduce or audit the design.',
+    description: 'Get one saved DOE design in full: factors and ranges, constraints, the model it was optimized for, generation settings (run budget, replicates, center points, seed), D-efficiency, and the complete run matrix with the formulation each run became. Everything needed to reproduce or audit the design.',
     inputSchema: {
       type: 'object',
       properties: {

package/tools/formulations.js

@@ -107,6 +107,19 @@ const get_formulation = {
       })),
       compositionFlattenedWtPct: flatRows,
       stepCount: (f.steps || []).length,
+      // The actual procedure — the tool description promises "step procedure",
+      // so return the ordered steps, not just the count. Keep only the
+      // meaningful fields; drop empties so simple recipes stay clean.
+      steps: (f.steps || []).map(s => ({
+        description: (s && (s.description || s.action || s.type)) || '',
+        ...(s && s.duration != null && s.duration !== '' ? { duration: s.duration } : {}),
+        ...(s && s.temperature != null && s.temperature !== '' ? { temperature: s.temperature } : {}),
+        ...(s && s.rpm != null && s.rpm !== '' ? { rpm: s.rpm } : {}),
+        ...(s && s.equipment ? { equipment: s.equipment } : {}),
+        ...(s && s.notes ? { notes: s.notes } : {}),
+      })),
+      // User-defined fields (incl. the "DOE factor"/"DOE value" convention).
+      customFields: (f.customFields || []).filter(c => c && c.name).map(c => ({ name: c.name, value: c.value != null ? c.value : '' })),
       batchCount: batches.length,
       sampleCount: samples.length,
     };

package/tools/ingredients.js

@@ -43,12 +43,14 @@ function _trimIngredient(i) {
     id: i.id,
     uid: i.uid,
     name: i.name,
+    chemicalName: i.chemicalName || '',
     family: i.family || '',
     supplier: i.supplier || '',
     casNumber: i.cas || i.casNumber || '',
     grade: i.grade || '',
     state: i.state || '',
     function: i.function || '',
+    storage: i.storage || '',
     mw: i.mw != null && i.mw !== '' ? Number(i.mw) : null,
     // % active for a technical/impure raw material (drives purity-corrected
     // weigh-out). null when full-strength / unspecified.

package/tools/lab.js

@@ -8,6 +8,44 @@
 
 import { getStore, resolveById } from '../data.js';
 
+// --- Self-contained unit conversion + actual-volume derivation ---------------
+// The MCP server has no access to the app's cost.js helpers, so a small local
+// factor table covers the common units. Mirrors js/views/batches.js:
+// _batchActualMassKg / _batchActualVolume — actual volume is measured directly
+// when logged, else actual mass ÷ measured finished-product density. Never a
+// sum of per-ingredient volumes (volume isn't additive; mass is).
+const _MASS_TO_KG = { mg: 1e-6, cg: 1e-5, dg: 1e-4, g: 1e-3, hg: 0.1, kg: 1, oz: 0.0283495, lb: 0.453592, stone: 6.35029, t: 1000, ton: 1000, tonne: 1000, grain: 6.47989e-5, 'µg': 1e-9, ug: 1e-9, mcg: 1e-9 };
+const _VOL_TO_L = { 'µl': 1e-6, ul: 1e-6, ml: 1e-3, cl: 1e-2, dl: 0.1, l: 1, gal: 3.78541, fl_oz: 0.0295735, floz: 0.0295735, pt: 0.473176, qt: 0.946353, tsp: 0.00492892, tbsp: 0.0147868, cup: 0.236588 };
+function _massToKg(v, u) { const f = _MASS_TO_KG[String(u || '').trim().toLowerCase()]; return (f != null && isFinite(v)) ? v * f : null; }
+function _volToL(v, u) { const f = _VOL_TO_L[String(u || '').trim().toLowerCase()]; return (f != null && isFinite(v)) ? v * f : null; }
+function _batchActualMassKg(b) {
+  const y = parseFloat(b.actualYield);
+  if (isFinite(y)) { const kg = _massToKg(y, b.unit); if (kg != null) return kg; }
+  if (Array.isArray(b.actualComposition)) {
+    let t = 0, any = false;
+    for (const c of b.actualComposition) { const kg = _massToKg(parseFloat(c.amount), c.unit); if (kg != null) { t += kg; any = true; } }
+    if (any) return t;
+  }
+  return null;
+}
+function _batchActualVolume(b) {
+  const mv = parseFloat(b.measuredVolume);
+  if (isFinite(mv) && mv > 0) { const L = _volToL(mv, b.measuredVolumeUnit || 'L'); if (L != null) return { liters: L, source: 'measured' }; }
+  const d = parseFloat(b.measuredDensity), m = _batchActualMassKg(b);
+  if (isFinite(d) && d > 0 && m != null) return { liters: m / d, source: 'derived' };
+  return null;
+}
+// Public shape for a batch's actual volume (or null). Includes the density used
+// (derived case) or implied by the measurement (measured case) for QC.
+function _actualVolumeInfo(b) {
+  const av = _batchActualVolume(b);
+  if (!av) return null;
+  const out = { liters: +av.liters.toFixed(4), unit: 'L', source: av.source };
+  if (av.source === 'derived') { const d = parseFloat(b.measuredDensity); if (isFinite(d)) out.densityUsed = d; }
+  else { const m = _batchActualMassKg(b); if (m != null && av.liters > 0) out.impliedDensity = +(m / av.liters).toFixed(4); }
+  return out;
+}
+
 function _trimBatch(b, formulationsById) {
   if (!b) return null;
   const f = b.formulationId ? formulationsById.get(b.formulationId) : null;
@@ -20,6 +58,14 @@ function _trimBatch(b, formulationsById) {
     targetQuantity: b.targetQuantity ?? null,
     unit: b.unit || '',
     actualYield: b.actualYield ?? null,
+    // Finished-product density (g/mL === kg/L), measured on the blend, + the
+    // derived/measured actual VOLUME (mass is the additive quantity; volume is
+    // measured or derived from density, never summed across ingredients).
+    measuredDensity: b.measuredDensity ?? null,
+    densityTempC: (b.densityTemp != null && b.densityTemp !== '') ? b.densityTemp : null,
+    measuredVolume: b.measuredVolume ?? null,
+    measuredVolumeUnit: b.measuredVolumeUnit || '',
+    actualVolume: _actualVolumeInfo(b),
     preparedDate: b.preparedDate || '',
     preparedBy: b.preparedBy || '',
     process: b.process || '',
@@ -95,7 +141,7 @@ const list_batches = {
 const get_batch = {
   definition: {
     name: 'get_batch',
-    description: 'Get full details for a single batch including its actual composition (as-prepared, when logged), child samples, lineage (parent / sub-blend parents), and inventory consumption note. Accepts internal id or UID.',
+    description: 'Get full details for a single batch including its actual composition (as-prepared, when logged), child samples, lineage (parent / sub-blend parents), inventory consumption note, and finished-product density + actual volume (measured directly or derived as actual mass ÷ measured density — never summed from per-ingredient volumes). Accepts internal id or UID.',
     inputSchema: {
       type: 'object',
       properties: {