@barivia/barmesh-mcp 0.4.1 → 0.5.0

package/dist/viz-server.js

@@ -0,0 +1,124 @@
+/**
+ * Local HTTP server for the barmesh results-explorer view when the MCP client
+ * does not support MCP Apps. Serves built HTML at /viz/:viewName and proxies API
+ * data at /api/results/:jobId and /api/results/:jobId/image/:filename.
+ * Bind to 127.0.0.1 only; port from BARIVIA_VIZ_PORT or OS-assigned.
+ */
+import http from "node:http";
+const ID_REGEX = /^[a-zA-Z0-9_-]+$/;
+const FILENAME_REGEX = /^[a-zA-Z0-9_.-]+$/;
+const ALLOWED_VIEWS = new Set(["barmesh-results-explorer"]);
+const CORS_HEADERS = {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+    "Access-Control-Allow-Headers": "Content-Type",
+};
+/** Start the local viz HTTP server. Returns the port (from BARIVIA_VIZ_PORT or OS-assigned). */
+export function startVizServer(apiCall, apiRawCall, loadViewHtml) {
+    const portOverride = process.env.BARIVIA_VIZ_PORT;
+    const port = portOverride ? parseInt(portOverride, 10) : 0;
+    if (portOverride && (Number.isNaN(port) || port < 0 || port > 65535)) {
+        return Promise.reject(new Error(`Invalid BARIVIA_VIZ_PORT: ${portOverride}`));
+    }
+    let assignedPort = port;
+    const portIsPinned = Boolean(portOverride);
+    const server = http.createServer(async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://127.0.0.1`);
+        const pathname = url.pathname;
+        const send = (status, body, contentType) => {
+            res.writeHead(status, { "Content-Type": contentType, ...CORS_HEADERS });
+            res.end(body);
+        };
+        const sendJson = (status, data) => {
+            res.writeHead(status, { "Content-Type": "application/json", ...CORS_HEADERS });
+            res.end(JSON.stringify(data));
+        };
+        if (req.method === "OPTIONS") {
+            res.writeHead(204, CORS_HEADERS);
+            res.end();
+            return;
+        }
+        const vizMatch = pathname.match(/^\/viz\/([^/]+)$/);
+        if (req.method === "GET" && vizMatch) {
+            const viewName = vizMatch[1];
+            if (!ALLOWED_VIEWS.has(viewName)) {
+                send(404, "Not found", "text/plain");
+                return;
+            }
+            const html = await loadViewHtml(viewName);
+            if (!html) {
+                send(404, "View not built. Run: npm run build:views", "text/plain");
+                return;
+            }
+            send(200, html, "text/html; charset=utf-8");
+            return;
+        }
+        if (req.method === "GET" && pathname === "/api/health") {
+            const out = { ok: true, viz_port: assignedPort, port_pinned: portIsPinned };
+            const jobId = url.searchParams.get("job_id");
+            if (jobId) {
+                if (!ID_REGEX.test(jobId)) {
+                    out.api_reachable = false;
+                    out.error = "Invalid job_id";
+                }
+                else {
+                    try {
+                        const data = (await apiCall("GET", `/v1/jobs/${jobId}`));
+                        out.api_reachable = true;
+                        out.job_status = data.status ?? null;
+                        out.job_progress = data.progress ?? null;
+                    }
+                    catch (err) {
+                        out.api_reachable = false;
+                        out.error = err instanceof Error ? err.message : "Request failed";
+                    }
+                }
+            }
+            sendJson(200, out);
+            return;
+        }
+        const resultsMatch = pathname.match(/^\/api\/results\/([^/]+)$/);
+        if (req.method === "GET" && resultsMatch) {
+            const jobId = resultsMatch[1];
+            if (!ID_REGEX.test(jobId)) {
+                sendJson(400, { error: "Invalid job_id" });
+                return;
+            }
+            try {
+                const data = await apiCall("GET", `/v1/results/${jobId}`);
+                sendJson(200, data);
+            }
+            catch (err) {
+                const status = err?.httpStatus ?? 500;
+                sendJson(status, { error: err instanceof Error ? err.message : "Request failed" });
+            }
+            return;
+        }
+        const imageMatch = pathname.match(/^\/api\/results\/([^/]+)\/image\/([^/]+)$/);
+        if (req.method === "GET" && imageMatch) {
+            const [, jobId, filename] = imageMatch;
+            if (!ID_REGEX.test(jobId) || !FILENAME_REGEX.test(filename)) {
+                sendJson(400, { error: "Invalid job_id or filename" });
+                return;
+            }
+            try {
+                const { data, contentType } = await apiRawCall(`/v1/results/${jobId}/image/${filename}`);
+                res.writeHead(200, { "Content-Type": contentType, ...CORS_HEADERS });
+                res.end(data);
+            }
+            catch {
+                sendJson(404, { error: "Image not found" });
+            }
+            return;
+        }
+        send(404, "Not found", "text/plain");
+    });
+    return new Promise((resolve, reject) => {
+        server.listen(port, "127.0.0.1", () => {
+            const assigned = server.address()?.port;
+            assignedPort = assigned ?? port;
+            resolve(assignedPort);
+        });
+        server.on("error", reject);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barivia/barmesh-mcp",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "barmesh MCP proxy — SOM-based CFD mesh-convergence and Richardson/GCI analysis on the Barivia cloud API",
   "keywords": [
     "mcp",
@@ -30,17 +30,20 @@
   },
   "files": [
     "LICENSE",
-    "dist/**/*.js"
+    "dist/**/*.js",
+    "dist/views/**/*.html"
   ],
   "scripts": {
     "minify": "terser dist/index.js -o dist/index.js -c -m --toplevel",
-    "build": "tsc && npm run minify",
-    "build:publish": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.publish.json && npm run minify",
+    "build": "tsc && npm run build:views && npm run minify",
+    "build:publish": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.publish.json && npm run build:views && npm run minify",
+    "build:views": "INPUT=src/views/barmesh-results-explorer/index.html vite build",
     "dev": "tsx src/index.ts",
     "test": "vitest run --config vitest.config.ts",
     "prepublishOnly": "npm run build:publish"
   },
   "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.23.0"
   },
@@ -49,6 +52,8 @@
     "terser": "^5.46.0",
     "tsx": "^4.19.0",
     "typescript": "^5.5.0",
+    "vite": "^7.3.1",
+    "vite-plugin-singlefile": "^2.3.0",
     "vitest": "^4.0.18"
   },
   "engines": {