@phidiassj/aiyoperps-mcp-installer 0.5.4 → 0.5.5

package/README.md

@@ -28,3 +28,4 @@ npx -y @phidiassj/aiyoperps-mcp-installer --url http://127.0.0.1:5078/mcp
 - For Codex, the installer writes `startup_timeout_sec = 60` because the first `npx` launch may take longer than the default 10-second startup timeout.
 - Before writing host config, the installer prewarms the bridge package with `npx ... --help` to reduce first-run startup latency.
 - The generated MCP entry includes `--startup-ping` so the bridge verifies the AiyoPerps MCP endpoint before entering stdio mode.
+- Before installation, the installer probes candidate MCP URLs and only writes config if it finds a reachable endpoint.

package/bin/aiyoperps-mcp-installer.js

@@ -229,7 +229,13 @@ async function installAll(hosts, url) {
     return;
   }
 
-  await prewarmBridgePackage(url);
+  const resolvedUrl = await resolveInstallUrl(url, cli.urlExplicit);
+  if (!resolvedUrl) {
+    return;
+  }
+
+  bindInstallActions(selected, resolvedUrl);
+  await prewarmBridgePackage(resolvedUrl);
   await runForHosts(selected, 'install');
 }
 
@@ -252,7 +258,13 @@ async function installAnyOf(rl, hosts, url) {
     return;
   }
 
-  await prewarmBridgePackage(url);
+  const resolvedUrl = await resolveInstallUrl(url, cli.urlExplicit);
+  if (!resolvedUrl) {
+    return;
+  }
+
+  bindInstallActions(selected, resolvedUrl);
+  await prewarmBridgePackage(resolvedUrl);
   await runForHosts(selected, 'install');
 }
 
@@ -317,6 +329,13 @@ async function runNonInteractive(cliArgs, hosts, url) {
       requireSupported: true,
       requireInstalled: false
     });
+    const resolvedUrl = await resolveInstallUrl(url, cliArgs.urlExplicit);
+    if (!resolvedUrl) {
+      return;
+    }
+
+    bindInstallActions(selected, resolvedUrl);
+    await prewarmBridgePackage(resolvedUrl);
     await runForHosts(selected, 'install');
     return;
   }
@@ -358,6 +377,27 @@ function selectHostsByIds(hosts, ids, requirements) {
   });
 }
 
+function bindInstallActions(hosts, url) {
+  for (const host of hosts) {
+    host.install = createInstallAction(host, url);
+  }
+}
+
+function createInstallAction(host, url) {
+  switch (host.id) {
+    case 'codex':
+      return () => installCodex(host.path, url);
+    case 'claude-code':
+      return () => installClaudeCode(url);
+    case 'claude-desktop':
+      return () => installClaudeDesktop(host.path, url);
+    case 'openclaw':
+      return () => installOpenClaw(url);
+    default:
+      return async () => { };
+  }
+}
+
 function installCodex(configPath, url) {
   ensureParentDir(configPath);
 
@@ -514,6 +554,88 @@ async function prewarmBridgePackage(url) {
   stdout.write('  prewarm complete\n');
 }
 
+async function resolveInstallUrl(defaultUrl, urlExplicit) {
+  const candidates = urlExplicit
+    ? [defaultUrl]
+    : buildCandidateUrls(defaultUrl);
+
+  stdout.write('\nProbing MCP endpoint candidates...\n');
+  for (const candidate of candidates) {
+    const ok = await canReachMcpEndpoint(candidate);
+    stdout.write(`  ${ok ? 'ok' : 'fail'} ${candidate}\n`);
+    if (ok) {
+      return candidate;
+    }
+  }
+
+  stdout.write(
+    'No reachable AiyoPerps MCP endpoint was detected. ' +
+    'Start the AiyoPerps HTTP API first or pass a valid --url, then retry.\n');
+  return null;
+}
+
+function buildCandidateUrls(defaultUrl) {
+  const urls = [
+    defaultUrl,
+    'http://localhost:5078/mcp',
+    'http://winhost:5078/mcp',
+    'http://host.docker.internal:5078/mcp'
+  ];
+
+  const wslGatewayUrl = detectWslGatewayUrl();
+  if (wslGatewayUrl) {
+    urls.push(wslGatewayUrl);
+  }
+
+  return [...new Set(urls)];
+}
+
+function detectWslGatewayUrl() {
+  if (!isWsl()) {
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync('/etc/resolv.conf', 'utf8');
+    const match = content.match(/^nameserver\s+([0-9.]+)\s*$/m);
+    return match ? `http://${match[1]}:5078/mcp` : null;
+  } catch {
+    return null;
+  }
+}
+
+async function canReachMcpEndpoint(url) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 2500);
+
+  try {
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json'
+      },
+      body: JSON.stringify({
+        jsonrpc: '2.0',
+        id: 'installer-probe',
+        method: 'ping',
+        params: {}
+      }),
+      signal: controller.signal
+    });
+
+    if (!response.ok) {
+      return false;
+    }
+
+    const payload = await response.json();
+    return !payload?.error;
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
 function hasCodexBlock(content) {
   return new RegExp(`^\\[mcp_servers\\.${SERVER_NAME}\\]\\s*$`, 'm').test(content);
 }
@@ -570,6 +692,10 @@ function resolveTargetUrl(args) {
   return env.AIYOPERPS_MCP_URL || DEFAULT_URL;
 }
 
+function isWsl() {
+  return Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP);
+}
+
 function parseCliArgs(args) {
   const install = [];
   const uninstall = [];
@@ -577,6 +703,7 @@ function parseCliArgs(args) {
   let statusOnly = false;
   let nonInteractive = false;
   let url = env.AIYOPERPS_MCP_URL || DEFAULT_URL;
+  let urlExplicit = Boolean(env.AIYOPERPS_MCP_URL);
 
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
@@ -626,11 +753,13 @@ function parseCliArgs(args) {
 
     if (arg.startsWith('--url=')) {
       url = arg.slice('--url='.length);
+      urlExplicit = true;
       continue;
     }
 
     if (arg === '--url' && index + 1 < args.length) {
       url = args[index + 1];
+      urlExplicit = true;
       index += 1;
       continue;
     }
@@ -642,7 +771,8 @@ function parseCliArgs(args) {
     installAll,
     statusOnly,
     nonInteractive,
-    url
+    url,
+    urlExplicit
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phidiassj/aiyoperps-mcp-installer",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Interactive installer for registering AiyoPerps MCP with supported AI agent hosts.",
   "license": "MIT",
   "type": "module",