@casys/mcp-erpnext 2.3.0 → 2.3.1

package/README.md

@@ -1,5 +1,11 @@
 # @casys/mcp-erpnext
 
+[![JSR](https://jsr.io/badges/@casys/mcp-erpnext)](https://jsr.io/@casys/mcp-erpnext)
+[![npm](https://img.shields.io/npm/v/@casys/mcp-erpnext?logo=npm&color=cb3837)](https://www.npmjs.com/package/@casys/mcp-erpnext)
+[![CI](https://github.com/Casys-AI/mcp-erpnext/actions/workflows/test.yml/badge.svg)](https://github.com/Casys-AI/mcp-erpnext/actions/workflows/test.yml)
+[![MCP](https://img.shields.io/badge/MCP-server-1f6feb?logo=modelcontextprotocol&logoColor=white)](https://modelcontextprotocol.io)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 MCP server for [ERPNext](https://erpnext.com) / Frappe ERP — **120 tools**
 across **14 categories**, with **7 interactive UI viewers**.
 
@@ -9,22 +15,59 @@ Copilot, custom) to your ERPNext instance via the
 
 Works with **self-hosted** and **ERPNext Cloud** (frappe.cloud) instances.
 
-## What's New in v2.1
-
-- **Cross-viewer navigation** — click a row in any list to drill down, click a
-  button to open related documents in another viewer via `sendMessage`
-- **Inline detail panels** — expand any row in doclist/stock viewers to see full
-  document details + action buttons (Submit, Cancel, Payments)
-- **Interactive charts** — click bar/pie/line data points to drill into
-  underlying documents
-- **KPI drill-down** — click the big number or sparkline to explore exceptions
-  or trends
-- **Funnel redesign** — trapezoid stages with gradient fills, conversion badges,
-  click-through navigation
-- **Better error messages** — Frappe API errors are now surfaced with full
-  detail instead of generic "Tool execution failed"
-- **VS Code Copilot fix** — schema validation issue with `erpnext_doc_list`
-  filters resolved (#2)
+## Screenshots
+
+Interactive viewers rendered inside an MCP host, driven entirely by tool
+results.
+
+<table>
+  <tr>
+    <td width="50%" align="center">
+      <img src="docs/assets/doclist-viewer.png" alt="Document list viewer with chip filters and inline detail" width="100%"><br>
+      <sub><b>doclist-viewer</b> — any DocType as a sortable table with chip filters and an inline detail panel</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="docs/assets/invoice-viewer.png" alt="Invoice viewer with line items and actions" width="100%"><br>
+      <sub><b>invoice-viewer</b> — invoice with parties, line items, item drill-down and Submit/Cancel/Payments</sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="docs/assets/funnel-viewer.png" alt="Sales funnel viewer" width="100%"><br>
+      <sub><b>funnel-viewer</b> — Lead → Opportunity → Quotation → Order with conversion rates</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="docs/assets/kpi-viewer.png" alt="KPI viewer with sparkline" width="100%"><br>
+      <sub><b>kpi-viewer</b> — big-number KPI with delta vs last period and a sparkline</sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="docs/assets/chart-viewer.png" alt="Chart viewer" width="100%"><br>
+      <sub><b>chart-viewer</b> — universal Recharts renderer (here: stock levels)</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="docs/assets/stock-viewer.png" alt="Stock balance viewer" width="100%"><br>
+      <sub><b>stock-viewer</b> — stock balance with color-coded quantity badges</sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="docs/assets/kanban-viewer.png" alt="Read-write kanban board" width="100%"><br>
+      <sub><b>kanban-viewer</b> — read-write board (Task / Opportunity / Issue) with inline edit</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="docs/assets/profit-loss.png" alt="Profit and loss composed chart" width="100%"><br>
+      <sub><b>chart-viewer</b> — composed dual-axis chart (here: profit &amp; loss)</sub>
+    </td>
+  </tr>
+</table>
+
+## What's New
+
+See the [CHANGELOG](CHANGELOG.md) for the full release history, or the
+[latest release](https://github.com/Casys-AI/mcp-erpnext/releases/latest) for
+the current version's highlights.
 
 ## Quick Start
 
@@ -293,19 +336,17 @@ cd src/ui && npm run dev:kanban
 
 ## Release Flow
 
-Release is intentionally GitHub-driven:
+Releases are manual and explicit:
 
-1. Run `deno task release:check` locally before publishing work.
-2. Push or merge to `main`.
-3. Release Please opens or updates the release PR with the semver bump,
-   `CHANGELOG.md`, `deno.json`, and `server.ts`.
-4. Merge the Release Please PR.
-5. `.github/workflows/release-please.yml` creates the GitHub release, then calls
-   `.github/workflows/publish.yml` to publish the released version to JSR and
+1. Update `deno.json`, `server.ts`, and `CHANGELOG.md`.
+2. Run `deno task release:check` locally.
+3. Commit and push the release commit to `main`.
+4. Create the GitHub release/tag, for example `v2.3.0`.
+5. Run the `Publish` workflow manually to publish the same version to JSR and
    npm.
 
-Do not bump versions manually unless bypassing Release Please for an emergency
-release.
+The package name stays `@casys/mcp-erpnext`; releases only bump the package
+version.
 
 ## License
 

package/mcp-erpnext.mjs

@@ -22327,6 +22327,21 @@ var HonoRequest = class {
   arrayBuffer() {
     return this.#cachedBody("arrayBuffer");
   }
+  /**
+   * `.bytes()` parses the request body as a `Uint8Array`.
+   *
+   * @see {@link https://hono.dev/docs/api/request#bytes}
+   *
+   * @example
+   * ```ts
+   * app.post('/entry', async (c) => {
+   *   const body = await c.req.bytes()
+   * })
+   * ```
+   */
+  bytes() {
+    return this.#cachedBody("arrayBuffer").then((buffer) => new Uint8Array(buffer));
+  }
   /**
    * Parses the request body as a `Blob`.
    * @example
@@ -23025,7 +23040,7 @@ var Hono = class _Hono {
         handler = async (c, next) => (await compose([], app.errorHandler)(c, () => r.handler(c, next))).res;
         handler[COMPOSED_HANDLER] = r.handler;
       }
-      subApp.#addRoute(r.method, r.path, handler);
+      subApp.#addRoute(r.method, r.path, handler, r.basePath);
     });
     return this;
   }
@@ -23149,7 +23164,7 @@ var Hono = class _Hono {
       const pathPrefixLength = mergedPath === "/" ? 0 : mergedPath.length;
       return (request) => {
         const url = new URL(request.url);
-        url.pathname = url.pathname.slice(pathPrefixLength) || "/";
+        url.pathname = this.getPath(request).slice(pathPrefixLength) || "/";
         return new Request(url, request);
       };
     })();
@@ -23163,10 +23178,15 @@ var Hono = class _Hono {
     this.#addRoute(METHOD_NAME_ALL, mergePath(path, "*"), handler);
     return this;
   }
-  #addRoute(method, path, handler) {
+  #addRoute(method, path, handler, baseRoutePath) {
     method = method.toUpperCase();
     path = mergePath(this._basePath, path);
-    const r = { basePath: this._basePath, path, method, handler };
+    const r = {
+      basePath: baseRoutePath !== void 0 ? mergePath(this._basePath, baseRoutePath) : this._basePath,
+      path,
+      method,
+      handler
+    };
     this.router.add(method, path, [handler, r]);
     this.routes.push(r);
   }
@@ -26468,12 +26488,16 @@ var LoaderState = class {
     }
     for (const [key, value] of Object.entries(source)) {
       if (Object.hasOwn(destination, key)) continue;
-      Object.defineProperty(destination, key, {
-        value,
-        writable: true,
-        enumerable: true,
-        configurable: true
-      });
+      if (key === "__proto__") {
+        Object.defineProperty(destination, key, {
+          value,
+          writable: true,
+          enumerable: true,
+          configurable: true
+        });
+      } else {
+        destination[key] = value;
+      }
       overridableKeys.add(key);
     }
   }
@@ -26507,12 +26531,16 @@ var LoaderState = class {
         this.#scanner.position = startPos || this.#scanner.position;
         throw this.#createError("Cannot store mapping pair: duplicated key");
       }
-      Object.defineProperty(result, keyNode, {
-        value: valueNode,
-        writable: true,
-        enumerable: true,
-        configurable: true
-      });
+      if (keyNode === "__proto__") {
+        Object.defineProperty(result, keyNode, {
+          value: valueNode,
+          writable: true,
+          enumerable: true,
+          configurable: true
+        });
+      } else {
+        result[keyNode] = valueNode;
+      }
       overridableKeys.delete(keyNode);
     }
     return result;
@@ -35994,18 +36022,26 @@ var analyticsTools = [
       if (input.warehouse) {
         filters.push(["warehouse", "=", input.warehouse]);
       }
+      let allowedItems = null;
       if (input.item_group) {
-        filters.push(["item_group", "=", input.item_group]);
+        const groupItems = await ctx.client.list("Item", {
+          fields: ["name"],
+          filters: [["item_group", "=", input.item_group]],
+          limit: 1e3
+        });
+        allowedItems = new Set(groupItems.map((i) => i.name));
       }
       const bins = await ctx.client.list("Bin", {
         fields: ["item_code", "warehouse", "actual_qty", "stock_value"],
         filters,
-        limit,
+        // widen the fetch when filtering by group in memory, then slice below
+        limit: allowedItems ? 1e3 : limit,
         order_by: "actual_qty desc"
       });
       const byItem = {};
       for (const bin of bins) {
         const item = bin.item_code;
+        if (allowedItems && !allowedItems.has(item)) continue;
         if (!byItem[item]) byItem[item] = { qty: 0, value: 0 };
         byItem[item].qty += Number(bin.actual_qty) || 0;
         byItem[item].value += Number(bin.stock_value) || 0;
@@ -38918,8 +38954,7 @@ async function main() {
   );
   const server = new McpApp({
     name: "mcp-erpnext",
-    version: "2.3.0",
-    // x-release-please-version
+    version: "2.3.1",
     maxConcurrent: 10,
     backpressureStrategy: "queue",
     validateSchema: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@casys/mcp-erpnext",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "MCP server for ERPNext with interactive UI viewers",
   "type": "module",
   "bin": {