routebase-mcp 1.0.0

package/bin/routebase-mcp.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+// routebase-mcp npm shim (MIT) — downloads the self-contained CLI binary for
+// this platform from releases.routebase.dev (pinned to this package version,
+// SHA-256 verified against the checksums baked in at publish time), caches it
+// under ~/.routebase/bin/<version>/, then execs it.
+//
+// IMPORTANT: the CLI speaks MCP over stdio — stdout belongs to the protocol.
+// All shim output goes to stderr. The downloaded binary is governed by the
+// Routebase terms (https://routebase.dev/); this shim itself is MIT.
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const https = require("node:https");
+const crypto = require("node:crypto");
+const { spawnSync } = require("node:child_process");
+
+const pkg = require("../package.json");
+const checksums = require("../checksums.json");
+
+const RID_MAP = {
+  "darwin arm64": "osx-arm64",
+  "darwin x64": "osx-x64",
+  "win32 x64": "win-x64",
+  "linux x64": "linux-x64",
+};
+
+function fail(message) {
+  process.stderr.write(`routebase-mcp: ${message}\n`);
+  process.exit(1);
+}
+
+const rid = RID_MAP[`${process.platform} ${process.arch}`];
+if (!rid) {
+  fail(
+    `unsupported platform ${process.platform}/${process.arch} — supported: macOS (arm64/x64), Windows (x64), Linux (x64)`,
+  );
+}
+
+const ext = rid === "win-x64" ? ".exe" : "";
+const fileName = `routebase-mcp-${rid}${ext}`;
+const expectedSha = checksums[fileName];
+if (!expectedSha) {
+  fail(`no checksum for ${fileName} in this package — refusing to download`);
+}
+
+const cacheDir = path.join(os.homedir(), ".routebase", "bin", pkg.version);
+const binPath = path.join(cacheDir, fileName);
+
+function download(url, dest, redirects = 0) {
+  return new Promise((resolve, reject) => {
+    if (redirects > 3) return reject(new Error("too many redirects"));
+    https
+      .get(url, (res) => {
+        if (res.statusCode >= 301 && res.statusCode <= 308 && res.headers.location) {
+          res.resume();
+          return resolve(download(res.headers.location, dest, redirects + 1));
+        }
+        if (res.statusCode !== 200) {
+          res.resume();
+          return reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+        }
+        const tmp = `${dest}.download`;
+        const out = fs.createWriteStream(tmp, { mode: 0o755 });
+        res.pipe(out);
+        out.on("finish", () => out.close(() => resolve(tmp)));
+        out.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+function sha256(file) {
+  return crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex");
+}
+
+async function ensureBinary() {
+  if (fs.existsSync(binPath)) return;
+  const url = `https://releases.routebase.dev/cli/${pkg.version}/${fileName}`;
+  process.stderr.write(`routebase-mcp: downloading ${url} (first run)\n`);
+  fs.mkdirSync(cacheDir, { recursive: true });
+  const tmp = await download(url, binPath);
+  const actual = sha256(tmp);
+  if (actual !== expectedSha) {
+    fs.rmSync(tmp, { force: true });
+    fail(`checksum mismatch for ${fileName} (expected ${expectedSha}, got ${actual})`);
+  }
+  fs.renameSync(tmp, binPath);
+  process.stderr.write(`routebase-mcp: cached at ${binPath}\n`);
+}
+
+ensureBinary()
+  .then(() => {
+    const result = spawnSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+    if (result.error) fail(result.error.message);
+    process.exit(result.status ?? 1);
+  })
+  .catch((err) => fail(err.message));

package/checksums.json

@@ -0,0 +1,6 @@
+{
+  "routebase-mcp-linux-x64": "9f5da21332a63bb54e56edb9133aafbef53843770beaf58f5bb2aa3aba52752c",
+  "routebase-mcp-osx-arm64": "078e3f64e78027f646c300c9d3e2c5876bb66c411a0cf344a6c5419b5713e8a8",
+  "routebase-mcp-osx-x64": "71ca1241b2251c6b25aa8623107383f08365e40e7b777b3bc6949aa94b0d60f9",
+  "routebase-mcp-win-x64.exe": "e85a3b92f30a1b3752104ab21618a14a59ed170334a2e8c6b0ea0e0f589262c4"
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "routebase-mcp",
+  "version": "1.0.0",
+  "description": "Routebase MCP server CLI — connect AI agents (Claude Code, Cursor, VS Code) to your Routebase APIs over stdio. Downloads the platform binary from releases.routebase.dev on first run.",
+  "bin": {
+    "routebase-mcp": "bin/routebase-mcp.js"
+  },
+  "files": [
+    "bin/",
+    "checksums.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "homepage": "https://routebase.dev/mcp-server/",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "api",
+    "openapi",
+    "routebase"
+  ]
+}