@zoer7788/mcp-nexus-node 0.1.0 → 0.1.2

package/README.md

@@ -14,7 +14,6 @@ On `pub-118`:
 
 ```bash
 npm install -g @zoer7788/mcp-nexus-node
-MCP_NEXUS_ADMIN_URL=https://mcpnexus-pub118.omji.top \
 mcp-nexus pair
 ```
 
@@ -32,4 +31,5 @@ mcp-nexus status
 ```
 
 DevSpace is installed as a package dependency. `cloudflared` must be available on
-the remote machine before creating public DevSpace projects.
+the remote machine. `mcp-nexus pair` creates the control tunnel automatically
+when Cloudflare auth is present at `~/.cloudflared/cert.pem`.

package/cli.js

@@ -63,6 +63,11 @@ function config() {
   };
 }
 
+function saveConfigPatch(patch) {
+  ensureState();
+  saveJson(configPath, { ...loadJson(configPath, {}), ...patch });
+}
+
 function tokens() {
   ensureState();
   return loadJson(tokensPath, {});
@@ -113,6 +118,17 @@ function adminUrl() {
   return cfg.adminUrl || `http://${localIp()}:${cfg.port || 9876}`;
 }
 
+function defaultControlHost() {
+  const cfg = config();
+  const id = readFileSync(nodeIdPath, "utf8").trim().slice(0, 8);
+  return `mcpnexus-${sanitize(hostname()).slice(0, 24)}-${id}.${cfg.baseDomain || "omji.top"}`;
+}
+
+function findCloudflareTunnel(name) {
+  const list = spawnSync("cloudflared", ["tunnel", "list"], { encoding: "utf8" }).stdout || "";
+  return list.split("\n").map((line) => line.trim().split(/\s+/)).find((cols) => cols[1] === name)?.[0] || "";
+}
+
 function json(res, status, body) {
   res.writeHead(status, {
     "content-type": "application/json; charset=utf-8",
@@ -168,7 +184,10 @@ function setupProject(input) {
   const name = String(input.name || "").trim();
   const root = String(input.root || input.path || "").trim();
   if (!name || !root) throw new Error("name and root are required");
-  if (!existsSync(root)) throw new Error(`root not found: ${root}`);
+  if (!existsSync(root)) {
+    if (input.createRoot) mkdirSync(root, { recursive: true });
+    else throw new Error(`root not found: ${root}`);
+  }
   const items = projects();
   if (items.some((p) => p.name === name)) throw new Error(`project already exists: ${name}`);
 
@@ -182,9 +201,8 @@ function setupProject(input) {
   const tunnelName = `devspace-${subdomain}`;
 
   let tunnelId = "";
-  const list = spawnSync("cloudflared", ["tunnel", "list"], { encoding: "utf8" }).stdout || "";
-  const existing = list.split("\n").map((line) => line.trim().split(/\s+/)).find((cols) => cols[1] === tunnelName);
-  if (existing) tunnelId = existing[0];
+  const existing = findCloudflareTunnel(tunnelName);
+  if (existing) tunnelId = existing;
   else {
     const created = run("cloudflared", ["tunnel", "create", tunnelName]);
     tunnelId = (created.match(/[0-9a-f-]{36}/) || [])[0] || "";
@@ -243,10 +261,59 @@ function setupProject(input) {
   };
   items.push(project);
   saveProjects(items);
-  startProject(name);
+  if (input.autostart !== false) startProject(name);
   return projectStatus(findProject(name));
 }
 
+function setupControl(hostnameValue) {
+  ensureState();
+  if (!commandExists("cloudflared")) throw new Error("cloudflared command not found");
+  const cfDir = join(home, ".cloudflared");
+  const certFile = join(cfDir, "cert.pem");
+  if (!existsSync(certFile)) throw new Error(`cloudflared is not logged in: ${certFile} not found`);
+  const host = String(hostnameValue || "").trim().toLowerCase();
+  if (!/^[a-z0-9.-]+$/.test(host) || !host.includes(".")) throw new Error("usage: mcp-nexus setup-control <hostname>");
+
+  const cfg = config();
+  const tunnelName = `mcp-nexus-${sanitize(host)}-control`;
+  let tunnelId = findCloudflareTunnel(tunnelName);
+  if (!tunnelId) {
+    const created = run("cloudflared", ["tunnel", "create", tunnelName]);
+    tunnelId = (created.match(/[0-9a-f-]{36}/) || [])[0] || "";
+    if (!tunnelId) throw new Error(`could not read tunnel id: ${created}`);
+  }
+  run("cloudflared", ["tunnel", "route", "dns", tunnelName, host]);
+
+  const cfConfig = join(cfDir, `${tunnelName}.yml`);
+  const credFile = join(cfDir, `${tunnelId}.json`);
+  writeFileSync(cfConfig, [
+    `tunnel: ${tunnelId}`,
+    `credentials-file: ${credFile}`,
+    "",
+    "ingress:",
+    `  - hostname: ${host}`,
+    `    service: http://127.0.0.1:${cfg.port || 9876}`,
+    "  - service: http_status:404",
+    "",
+  ].join("\n"));
+
+  const child = spawn("cloudflared", ["tunnel", "--protocol", "http2", "--config", cfConfig, "run"], {
+    detached: true,
+    stdio: ["ignore", "ignore", "ignore"],
+  });
+  child.unref();
+  saveConfigPatch({ adminUrl: `https://${host}` });
+  console.log(`Admin URL: https://${host}`);
+  console.log(`Control tunnel: ${tunnelName}`);
+  console.log("Next: mcp-nexus pair");
+}
+
+function ensureControl() {
+  const cfg = config();
+  if (cfg.adminUrl || process.env.MCP_NEXUS_ADMIN_URL) return;
+  setupControl(defaultControlHost());
+}
+
 function spawnLogged(project, cmd, args, env, logName) {
   const logPath = join(logDir, logName);
   const child = spawn(cmd, args, {
@@ -373,6 +440,7 @@ function startServeDetached() {
 
 async function pair() {
   ensureState();
+  ensureControl();
   const cfg = config();
   const pairCode = String(Math.floor(100000 + Math.random() * 900000));
   const pairingSecret = randomHex(16);
@@ -405,7 +473,8 @@ function status() {
 const command = process.argv[2] || "help";
 if (command === "serve") serve();
 else if (command === "pair") pair().catch((error) => { console.error(error.message); process.exit(1); });
+else if (command === "setup-control") { try { setupControl(process.argv[3]); } catch (error) { console.error(error.message); process.exit(1); } }
 else if (command === "status") status();
 else {
-  console.log("Usage: mcp-nexus <pair|serve|status>");
+  console.log("Usage: mcp-nexus <setup-control|pair|serve|status>");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoer7788/mcp-nexus-node",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Remote node for MCP Nexus pairing and DevSpace project control.",
   "license": "MIT",
   "type": "module",