@qe-mcp/server-ena 0.1.4 → 0.1.6

package/README.md

@@ -30,7 +30,24 @@ Gives Claude a set of ENA tools that run **locally on your machine**. The WASM m
 
 ## Installation
 
-The package is published to the public npm registry — no registry configuration needed.
+### Recommended — one-click desktop extension (`.mcpb`)
+
+The easiest install, no terminal or config files. Download `server-ena.mcpb`
+from the [releases](https://qe-libs.org/mcp/qe-mcp-server-ena/), then in
+Claude Desktop go to **Settings → Extensions** and drag the file in (or
+double-click it). Click Install and restart. Node.js ships inside Claude
+Desktop, so nothing else is required.
+
+The bundle is pure JS/WASM and cross-platform. It produces SVG (`svg_plot`)
+and interactive HTML (`interactive_plot`) plots; inline PNG rendering is
+omitted from the bundle (it requires a native module) — open the SVG or HTML
+to view the network.
+
+To build the bundle yourself: `bash scripts/build-mcpb.sh` → `dist/server-ena.mcpb`.
+
+---
+
+The package is also published to the public npm registry — no registry configuration needed.
 
 ### Option A — npx (no install needed)
 

package/manifest.json

@@ -0,0 +1,60 @@
+{
+  "manifest_version": "0.2",
+  "name": "server-ena",
+  "display_name": "ENA — Epistemic Network Analysis",
+  "version": "0.1.6",
+  "description": "Epistemic Network Analysis on tabular coded data. Runs entirely on your machine — data never leaves your computer.",
+  "long_description": "Model patterns of co-occurrence between coded events (discourse moves, behaviors, features) within conversations. The full ENA pipeline — accumulate, normalize, rotate, project, node positions — runs locally in WebAssembly; only results and plots are returned. Provides ena_profile (privacy-safe column metadata), ena_inspect (triage), ena_fit, ena_compare_groups (mean-rotation group comparison), ena_plot (rendered network views), and ena_accumulate. Prefer a file path over pasted data so raw rows stay on your machine.",
+  "author": {
+    "name": "Cody L Marquart",
+    "email": "clmarquart@wisc.edu"
+  },
+  "homepage": "https://qe-libs.org/mcp/qe-mcp-server-ena/",
+  "documentation": "https://qe-libs.org/mcp/qe-mcp-server-ena/",
+  "license": "GPL-3.0-only",
+  "keywords": [
+    "ena",
+    "epistemic-network-analysis",
+    "quantitative-ethnography",
+    "discourse-analysis",
+    "learning-analytics",
+    "wasm"
+  ],
+  "server": {
+    "type": "node",
+    "entry_point": "server.js",
+    "mcp_config": {
+      "command": "node",
+      "args": [
+        "${__dirname}/server.js"
+      ],
+      "env": {}
+    }
+  },
+  "tools": [
+    {
+      "name": "ena_profile",
+      "description": "Privacy-safe column metadata for a local CSV — no raw data transmitted."
+    },
+    {
+      "name": "ena_inspect",
+      "description": "Triage a dataset for ENA suitability; suggests codes, units, and conversations."
+    },
+    {
+      "name": "ena_fit",
+      "description": "Fit a full ENA model; returns a reusable model_id and a network plot."
+    },
+    {
+      "name": "ena_compare_groups",
+      "description": "Mean-rotation comparison of two groups; returns a model_id and plots."
+    },
+    {
+      "name": "ena_plot",
+      "description": "Render a network view (all, group, unit, comparison, subtraction) from a cached model_id."
+    },
+    {
+      "name": "ena_accumulate",
+      "description": "Accumulation step only — raw per-unit co-occurrence networks."
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qe-mcp/server-ena",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "MCP server for Epistemic Network Analysis — WASM backend, zero Python dependency",
   "type": "module",
   "main": "server.js",

package/scripts/build-mcpb.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# build-mcpb.sh — Produce a cross-platform .mcpb desktop-extension bundle.
+#
+# Stages only the runtime files plus a pure JS/WASM node_modules (optional deps
+# omitted, so the native @resvg/resvg-js is excluded and the bundle works on any
+# platform). PNG output is disabled in the bundle; SVG + interactive HTML remain.
+#
+# Usage:  bash scripts/build-mcpb.sh
+# Output: dist/server-ena.mcpb
+
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+STAGE="$(mktemp -d)/server-ena"
+OUT="${ROOT}/dist"
+
+echo "Staging runtime files → ${STAGE}"
+mkdir -p "${STAGE}" "${OUT}"
+
+# Runtime files only (server.js resolves qeviz from node_modules, so the
+# repo-root qeviz-*.js/html dev artifacts and tests are not needed).
+cp "${ROOT}/server.js"     "${STAGE}/"
+cp "${ROOT}/manifest.json" "${STAGE}/"
+cp "${ROOT}/package.json"  "${STAGE}/"
+
+# Keep the bundle's manifest version in lockstep with package.json.
+VERSION="$(node -e "process.stdout.write(require('${ROOT}/package.json').version)")"
+node -e "
+  const fs = require('fs');
+  const p = '${STAGE}/manifest.json';
+  const m = JSON.parse(fs.readFileSync(p, 'utf8'));
+  m.version = '${VERSION}';
+  fs.writeFileSync(p, JSON.stringify(m, null, 2) + '\n');
+"
+echo "Manifest version synced to ${VERSION}"
+cp "${ROOT}/package-lock.json" "${STAGE}/" 2>/dev/null || true
+[ -f "${ROOT}/README.md" ] && cp "${ROOT}/README.md" "${STAGE}/"
+[ -f "${ROOT}/.npmrc" ]    && cp "${ROOT}/.npmrc"    "${STAGE}/"
+
+echo "Installing production deps without optional (pure JS/WASM)…"
+( cd "${STAGE}" && npm install --omit=optional --omit=dev --no-audit --no-fund --silent )
+
+# Drop the .npmrc so the registry token/config isn't shipped in the bundle.
+rm -f "${STAGE}/.npmrc"
+
+# Some npm versions (e.g. 9.x) still materialize root-level optionalDependencies
+# despite --omit=optional. Remove the native rasterizer explicitly so the bundle
+# stays pure JS/WASM and cross-platform. The server degrades gracefully without it.
+rm -rf "${STAGE}"/node_modules/@resvg
+
+# Sanity: the native rasterizer must NOT be present in the bundle.
+if [ -d "${STAGE}/node_modules/@resvg" ]; then
+    echo "ERROR: @resvg present in bundle — not cross-platform. Aborting." >&2
+    exit 1
+fi
+
+echo "Packing bundle…"
+mcpb pack "${STAGE}" "${OUT}/server-ena.mcpb"
+
+echo ""
+echo "Built: ${OUT}/server-ena.mcpb"
+mcpb info "${OUT}/server-ena.mcpb" 2>/dev/null | head -20 || true

package/server.js

@@ -303,7 +303,23 @@ async function renderSVG(modelData, opts = {}) {
     if (!svgHtml.includes('xmlns=')) {
         svgHtml = svgHtml.replace('<svg', '<svg xmlns="http://www.w3.org/2000/svg"');
     }
-    return svgHtml;
+    return withWhiteBackground(svgHtml);
+}
+
+// The qeviz SVG has a transparent background, which makes the plot invisible in
+// dark-mode viewers. Insert an opaque white rect as the first child (behind all
+// content), sized to the SVG's viewBox so it covers the full canvas.
+function withWhiteBackground(svgHtml) {
+    const openTagMatch = svgHtml.match(/<svg[^>]*>/);
+    if (!openTagMatch) return svgHtml;
+    const openTag = openTagMatch[0];
+
+    const vb = openTag.match(/viewBox\s*=\s*["']\s*([-\d.]+)\s+([-\d.]+)\s+([-\d.]+)\s+([-\d.]+)\s*["']/);
+    const rect = vb
+        ? `<rect x="${vb[1]}" y="${vb[2]}" width="${vb[3]}" height="${vb[4]}" fill="#ffffff"/>`
+        : `<rect x="0" y="0" width="100%" height="100%" fill="#ffffff"/>`;
+
+    return svgHtml.replace(openTag, openTag + rect);
 }
 
 // ── Model / accumulation cache ────────────────────────────────────────────────