@phidiassj/aiyoperps-mcp-installer 0.5.4 → 0.5.6

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

@@ -9,6 +9,17 @@ import { parse as parseToml } from 'smol-toml';
 
 const SERVER_NAME = 'aiyoperps';
 const DEFAULT_URL = 'http://127.0.0.1:5078/mcp';
+const BRIDGE_PACKAGE_NAME = '@phidiassj/aiyoperps-mcp-bridge';
+const BRIDGE_SCRIPT_RELATIVE_PATH = path.join(
+  'node_modules',
+  '@phidiassj',
+  'aiyoperps-mcp-bridge',
+  'bin',
+  'aiyoperps-mcp-bridge.js');
+const EXECUTABLE_CACHE = new Map();
+let bridgeRuntimePrepared = false;
+let bridgeRuntimeAttempted = false;
+let bridgeRuntimeWarning = '';
 
 const cli = parseCliArgs(argv.slice(2));
 const targetUrl = cli.url;
@@ -229,7 +240,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 +269,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 +340,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 +388,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);
 
@@ -501,17 +552,73 @@ function buildJsonServerConfig(url) {
 }
 
 async function prewarmBridgePackage(url) {
-  stdout.write('\nPrewarming npm bridge package...\n');
-  const commandLine = resolveCommandLineSpec(process.platform, url, {
-    prewarm: true
-  });
-  const result = runCommand(commandLine.command, commandLine.args);
-  if (!result.ok) {
-    stdout.write(`  warning: prewarm failed: ${result.stderr || result.error?.message || 'unknown error'}\n`);
+  stdout.write('\nPreparing bridge runtime...\n');
+  await ensureBridgeRuntimePrepared();
+  if (bridgeRuntimePrepared) {
+    stdout.write(`  ready: ${resolveInstalledBridgeScriptPath()}\n`);
     return;
   }
 
-  stdout.write('  prewarm complete\n');
+  stdout.write(`  warning: ${bridgeRuntimeWarning || 'falling back to npx'}\n`);
+}
+
+async function resolveInstallUrl(defaultUrl, urlExplicit) {
+  await ensureBridgeRuntimePrepared();
+  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 commandLine = resolveCommandLineSpec(process.platform, url, {
+    healthCheck: true
+  });
+  const result = runCommand(commandLine.command, commandLine.args);
+  return result.ok;
 }
 
 function hasCodexBlock(content) {
@@ -570,6 +677,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 +688,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 +738,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 +756,8 @@ function parseCliArgs(args) {
     installAll,
     statusOnly,
     nonInteractive,
-    url
+    url,
+    urlExplicit
   };
 }
 
@@ -654,26 +769,101 @@ function splitCsvArg(value) {
 }
 
 function resolveCommandLineSpec(platform, url, options = {}) {
-  const packageArgs = ['-y', '@phidiassj/aiyoperps-mcp-bridge'];
+  const bridgeArgs = [];
   if (options.prewarm) {
-    packageArgs.push('--help');
+    bridgeArgs.push('--help');
+  } else if (options.healthCheck) {
+    bridgeArgs.push('--health-check', '--quiet', '--url', url);
   } else {
-    packageArgs.push('--startup-ping', '--url', url);
+    bridgeArgs.push('--startup-ping', '--url', url);
+  }
+
+  const installedScriptPath = resolveInstalledBridgeScriptPath();
+  if (installedScriptPath) {
+    return {
+      command: process.execPath,
+      args: [installedScriptPath, ...bridgeArgs]
+    };
   }
 
+  const packageArgs = ['-y', BRIDGE_PACKAGE_NAME, ...bridgeArgs];
+  const resolvedNpx = resolveExecutablePath(platform === 'win32' ? 'npx.cmd' : 'npx');
   if (platform === 'win32') {
     return {
-      command: 'npx.cmd',
+      command: resolvedNpx || 'npx.cmd',
       args: packageArgs
     };
   }
 
   return {
-    command: 'npx',
+    command: resolvedNpx || 'npx',
     args: packageArgs
   };
 }
 
+async function ensureBridgeRuntimePrepared() {
+  if (bridgeRuntimeAttempted) {
+    return bridgeRuntimePrepared;
+  }
+
+  bridgeRuntimeAttempted = true;
+
+  if (resolveInstalledBridgeScriptPath()) {
+    bridgeRuntimePrepared = true;
+    return true;
+  }
+
+  const npmCommand = resolveExecutablePath(process.platform === 'win32' ? 'npm.cmd' : 'npm');
+  if (!npmCommand) {
+    bridgeRuntimeWarning = 'npm was not found in PATH, falling back to npx.';
+    return false;
+  }
+
+  const installRoot = resolveBridgeInstallRoot();
+  ensureParentDir(path.join(installRoot, 'placeholder'));
+
+  const result = runCommand(npmCommand, [
+    'install',
+    '--silent',
+    '--no-audit',
+    '--no-fund',
+    '--prefix',
+    installRoot,
+    BRIDGE_PACKAGE_NAME
+  ]);
+
+  if (!result.ok) {
+    bridgeRuntimeWarning = result.stderr || result.error?.message || 'npm install failed, falling back to npx.';
+    return false;
+  }
+
+  if (!resolveInstalledBridgeScriptPath()) {
+    bridgeRuntimeWarning = 'bridge package installed, but launcher script was not found; falling back to npx.';
+    return false;
+  }
+
+  bridgeRuntimePrepared = true;
+  return true;
+}
+
+function resolveBridgeInstallRoot() {
+  if (env.AIYOPERPS_MCP_BRIDGE_DIR) {
+    return env.AIYOPERPS_MCP_BRIDGE_DIR;
+  }
+
+  if (process.platform === 'win32') {
+    const appData = env.LOCALAPPDATA || path.join(env.USERPROFILE || os.homedir(), 'AppData', 'Local');
+    return path.join(appData, 'AiyoPerps', 'mcp-bridge');
+  }
+
+  return path.join(os.homedir(), '.aiyoperps', 'mcp-bridge');
+}
+
+function resolveInstalledBridgeScriptPath() {
+  const scriptPath = path.join(resolveBridgeInstallRoot(), BRIDGE_SCRIPT_RELATIVE_PATH);
+  return fileExists(scriptPath) ? scriptPath : null;
+}
+
 function resolveCodexConfigPath() {
   if (env.CODEX_CONFIG_PATH) {
     return env.CODEX_CONFIG_PATH;
@@ -738,6 +928,35 @@ function runCommand(command, args) {
   };
 }
 
+function resolveExecutablePath(name) {
+  if (EXECUTABLE_CACHE.has(name)) {
+    return EXECUTABLE_CACHE.get(name);
+  }
+
+  const pathValue = env.PATH || '';
+  const separator = process.platform === 'win32' ? ';' : ':';
+  const extensions = process.platform === 'win32'
+    ? ['', '.cmd', '.exe', '.bat']
+    : [''];
+
+  for (const directory of pathValue.split(separator)) {
+    if (!directory) {
+      continue;
+    }
+
+    for (const extension of extensions) {
+      const candidate = path.join(directory, name.endsWith(extension) ? name : `${name}${extension}`);
+      if (fileExists(candidate)) {
+        EXECUTABLE_CACHE.set(name, candidate);
+        return candidate;
+      }
+    }
+  }
+
+  EXECUTABLE_CACHE.set(name, null);
+  return null;
+}
+
 function ensureParentDir(filePath) {
   fs.mkdirSync(path.dirname(filePath), { recursive: true });
 }

package/package.json

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