formlab-mcp 0.6.52 → 0.6.53

package/README.md

@@ -29,7 +29,7 @@ Ask Claude (or another MCP client) things like:
 
 | Tool | Purpose |
 |---|---|
-| `list_formulations` | Filtered list of recipes |
+| `list_formulations` | Filtered list of recipes, each with exact `batchCount` / `sampleCount` / `testReportCount`; `sort` (`batches`, `samples`, `test_reports`, `name`, `updated`) ranks every match before the limit — "which formulas have the most batch runs?" in one call |
 | `get_formulation` | Full record (incl. `versionLabel`, the label the user types, e.g. 1.0) + **version history** (`versionHistory`: one snapshot per save, v1, v2…, newest first, with the label each save had and its note) + flattened wt-% composition (sub-formulas expanded), the ordered **step procedure**, user **custom fields**, any **process-factor values** (DOE inputs — cure temp, mix time, RPM, pH…), the declared **finishedDensity** (g/mL of the mixed product; volume-targeted batches scale by it), and its **theoretical parameters computed** the way the app's Params tab does (Energy kcal/100g, NV %, Cost/kg…: value, unit, formula, spec pass/fail, and a `warning` when ingredients lack a value or carry mixed units) — the app's own engine, vendored in `mcp/vendor/` and run in an isolated `node:vm` context |
 | `find_similar_formulations` | Find formulas using a given ingredient ≥ threshold % |
 | `compare_formulations` | Pairwise side-by-side composition diff |

package/data.js

@@ -97,9 +97,35 @@ function _buildIndexes(db) {
     templatesById:    byId(db.templates),
     parametersById:   byId(db.parameters),
     equipmentById:    byId(db.equipment),
+    formulationCounts: _formulationCounts(db),
   };
 }
 
+// Exact batch / sample / test-report counts per formula id, built once per load so
+// list_formulations can rank every formula in O(n). Same rule as the app's AI context
+// (js/gemini.js _fCounts, build 22m): a sample counts toward its own formulationId, or
+// its batch's formula; a test report through its sample, else its own formulationId.
+function _formulationCounts(db) {
+  const counts = new Map();
+  const bump = (fid, k) => {
+    if (!fid) return;
+    let c = counts.get(fid);
+    if (!c) counts.set(fid, c = { batches: 0, samples: 0, testReports: 0 });
+    c[k]++;
+  };
+  const batchFid = new Map();
+  (db.batches || []).forEach(b => { if (b) { bump(b.formulationId, 'batches'); batchFid.set(b.id, b.formulationId); } });
+  const sampleFid = new Map();
+  (db.samples || []).forEach(s => {
+    if (!s) return;
+    const fid = s.formulationId || batchFid.get(s.batchId);
+    sampleFid.set(s.id, fid);
+    bump(fid, 'samples');
+  });
+  (db.testResults || []).forEach(t => { if (t) bump(sampleFid.get(t.sampleId) || t.formulationId, 'testReports'); });
+  return counts;
+}
+
 // ============================================================
 // Shared helpers used across tools
 // ============================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formlab-mcp",
-  "version": "0.6.52",
+  "version": "0.6.53",
   "mcpName": "io.github.juliu1980/formlab-mcp",
   "description": "Read-only Model Context Protocol server for FormLab \u2014 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.52",
+  "version": "0.6.53",
   "websiteUrl": "https://formvix.com/mcp",
   "repository": {
     "url": "https://github.com/juliu1980/FormLab",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "formlab-mcp",
-      "version": "0.6.52",
+      "version": "0.6.53",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/tools/formulations.js

@@ -13,6 +13,7 @@ import { theoreticalParams } from '../theoretical.js';
 // while keeping the human-facing fields the user cares about.
 function _trimFormulation(f) {
   if (!f) return null;
+  const counts = getStore().indexes.formulationCounts.get(f.id);
   return {
     id: f.id,
     uid: f.uid,
@@ -39,13 +40,23 @@ function _trimFormulation(f) {
     compositionRowCount: (f.composition || []).length,
     hasSubFormulas: (f.composition || []).some(c => c && c.formulationId),
     updatedAt: f.updatedAt || null,
+    // Exact counts (a sample through its batch, a test report through its sample).
+    batchCount: counts ? counts.batches : 0,
+    sampleCount: counts ? counts.samples : 0,
+    testReportCount: counts ? counts.testReports : 0,
   };
 }
 
+const _SORTS = {
+  batches: (c) => (c ? c.batches : 0),
+  samples: (c) => (c ? c.samples : 0),
+  test_reports: (c) => (c ? c.testReports : 0),
+};
+
 const list_formulations = {
   definition: {
     name: 'list_formulations',
-    description: 'List formulations (recipes) in the FormLab database, optionally filtered by status, project, family, tag, or name pattern. Returns one row per formula with key metadata. Use get_formulation for the full composition.',
+    description: 'List formulations (recipes) in the FormLab database, optionally filtered by status, project, family, tag, or name pattern. Returns one row per formula with key metadata and exact batchCount / sampleCount / testReportCount (a sample counts toward its batch\'s formula, a test report toward its sample\'s). To rank formulas (e.g. "which formulas have the most batch runs?") pass sort — it orders every matching formula before the limit is applied, so do not page through the list or call get_formulation per formula. Use get_formulation for the full composition.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -54,6 +65,7 @@ const list_formulations = {
         family: { type: 'string', description: 'Filter by formula family (e.g. "Acrylic Coating", "Skin Serum"). Case-insensitive substring.' },
         tag: { type: 'string', description: 'Filter to formulas containing this tag.' },
         name_contains: { type: 'string', description: 'Case-insensitive substring match on formula name.' },
+        sort: { type: 'string', enum: ['batches', 'samples', 'test_reports', 'name', 'updated'], description: 'Order before the limit: batches / samples / test_reports = most first; name = A–Z; updated = most recently updated first. Default: database order.' },
         limit: { type: 'number', description: 'Max rows to return (default 50, max 500).' },
       },
     },
@@ -75,9 +87,22 @@ const list_formulations = {
       if (args.name_contains && !norm(f.name).includes(norm(args.name_contains))) return false;
       return true;
     });
+    if (args.sort && Object.hasOwn(_SORTS, args.sort)) {
+      const key = _SORTS[args.sort];
+      const val = (f) => key(indexes.formulationCounts.get(f.id));
+      filtered.sort((a, b) => val(b) - val(a));
+    } else if (args.sort === 'name') {
+      filtered.sort((a, b) => String(a.name || '').localeCompare(String(b.name || ''), undefined, { numeric: true, sensitivity: 'base' }));
+    } else if (args.sort === 'updated') {
+      const ts = (v) => (typeof v === 'number' ? v : Date.parse(v) || 0);
+      filtered.sort((a, b) => ts(b.updatedAt) - ts(a.updatedAt));
+    } else if (args.sort) {
+      return { error: `Unknown sort "${args.sort}". Use one of: batches, samples, test_reports, name, updated.` };
+    }
     return {
       totalMatching: filtered.length,
       returned: Math.min(filtered.length, limit),
+      ...(args.sort ? { sortedBy: args.sort } : {}),
       formulations: filtered.slice(0, limit).map(_trimFormulation),
     };
   },