@diffui.mcp/install 0.1.0

package/README.md

@@ -0,0 +1,63 @@
+# @diffui.mcp/install
+
+Thin Node launcher for the diffui MCP server. Cursor (and other MCP hosts) run:
+
+```json
+{
+  "type": "stdio",
+  "command": "npx",
+  "args": ["-y", "@diffui.mcp/install@latest"],
+  "env": {
+    "DIFFUI_API_BASE": "https://diffui.ai",
+    "DIFFUI_API_KEY": "dui_..."
+  }
+}
+```
+
+On first start, the launcher downloads the platform `diffui-mcp` binary from
+`{DIFFUI_API_BASE}/mcp/` into `~/.diffui/bin/diffui-mcp`, then execs it with
+inherited stdio. Credentials can also come from the MCP `authenticate` tool
+(`~/.diffui/credentials`).
+
+## Publish to npm
+
+Prerequisites:
+
+1. MCP binaries served at `https://diffui.ai/mcp/*` (run `./scripts/build-mcp.sh`
+   and deploy `frontend/mcp/` with the app).
+2. npm account in the [@diffui.mcp](https://www.npmjs.com/org/diffui.mcp) org.
+
+```bash
+cd packages/mcp-install
+npm login
+npm publish --access public
+```
+
+Scoped packages must use `--access public` unless the org is on a private plan.
+
+Bump version for updates:
+
+```bash
+npm version patch
+npm publish --access public
+```
+
+## Local test before publish
+
+```bash
+cd packages/mcp-install
+chmod +x launcher.mjs
+DIFFUI_API_BASE=http://localhost:3040 DIFFUI_API_KEY=dui_... node launcher.mjs
+```
+
+Or link into a global MCP config:
+
+```bash
+npm link
+# mcp.json: "command": "diffui-mcp-install", "args": []
+```
+
+## Cursor deeplink
+
+The diffui app builds install links with `command: npx` and
+`args: ["-y", "@diffui.mcp/install@latest"]` plus env for API base and key.

package/launcher.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * diffui MCP launcher for Cursor / Claude / npx.
+ * Ensures ~/.diffui/bin/diffui-mcp exists, then execs it with inherited stdio.
+ *
+ * Env (from Cursor mcp.json or shell):
+ *   DIFFUI_API_BASE — API origin (default https://diffui.ai)
+ *   DIFFUI_API_KEY  — optional; authenticate tool can store ~/.diffui/credentials
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { chmodSync, createWriteStream, existsSync, mkdirSync } from "node:fs";
+import { arch, homedir, platform } from "node:os";
+import { dirname, join } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { get as httpsGet } from "node:https";
+import { get as httpGet } from "node:http";
+
+const base = String(process.env.DIFFUI_API_BASE || "https://diffui.ai").replace(/\/+$/, "");
+const dest = join(homedir(), ".diffui", "bin", "diffui-mcp");
+
+function binaryName() {
+  if (platform() === "darwin") {
+    return arch() === "arm64" ? "diffui-mcp-darwin-arm64" : "diffui-mcp-darwin-x64";
+  }
+  if (platform() === "linux") {
+    return "diffui-mcp-linux-x64";
+  }
+  if (platform() === "win32") {
+    return "diffui-mcp-windows-x64.exe";
+  }
+  throw new Error(`diffui-mcp: unsupported platform ${platform()}-${arch()}`);
+}
+
+async function download(url, path) {
+  const getter = url.startsWith("https:") ? httpsGet : httpGet;
+  await new Promise((resolve, reject) => {
+    getter(url, (res) => {
+      if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        download(res.headers.location, path).then(resolve, reject);
+        return;
+      }
+      if (res.statusCode !== 200) {
+        reject(new Error(`GET ${url} failed: HTTP ${res.statusCode}`));
+        res.resume();
+        return;
+      }
+      const type = String(res.headers["content-type"] || "").toLowerCase();
+      if (type.includes("text/html")) {
+        reject(new Error(`GET ${url} returned HTML — MCP binary missing on ${base}`));
+        res.resume();
+        return;
+      }
+      mkdirSync(dirname(path), { recursive: true });
+      pipeline(res, createWriteStream(path)).then(resolve, reject);
+    }).on("error", reject);
+  });
+}
+
+function clearQuarantine(path) {
+  if (platform() !== "darwin") return;
+  spawnSync("xattr", ["-dr", "com.apple.quarantine", path], { stdio: "ignore" });
+}
+
+async function ensureBinary() {
+  if (existsSync(dest)) return dest;
+  const name = binaryName();
+  const url = `${base}/mcp/${name}`;
+  process.stderr.write(`diffui-mcp: downloading ${name} from ${base}/mcp/\n`);
+  await download(url, dest);
+  chmodSync(dest, 0o755);
+  clearQuarantine(dest);
+  return dest;
+}
+
+const bin = await ensureBinary();
+const child = spawn(bin, [], {
+  stdio: "inherit",
+  env: process.env,
+});
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@diffui.mcp/install",
+  "version": "0.1.0",
+  "description": "Launcher for the diffui MCP server (stdio). Used by Cursor Add to Cursor.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "diffui-mcp-install": "launcher.mjs"
+  },
+  "files": [
+    "launcher.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}