@phidiassj/aiyoperps-mcp-installer 0.5.8 → 0.6.7

package/README.md

@@ -25,7 +25,8 @@ npx -y @phidiassj/aiyoperps-mcp-installer --url http://127.0.0.1:5078/mcp
 
 - The installer creates `*.bak` backups before editing local config files.
 - If a host is detected but not considered safe to modify, the installer reports it and skips automatic changes.
-- 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.
+- For Codex, the installer writes `startup_timeout_sec = 60`.
+- Before writing host config, the installer installs the bridge package into a stable local runtime directory instead of relying on `npx` at every startup.
+- The generated MCP entry uses `node <local bridge script> --debug-log <local log path> --quiet --url <detected endpoint>`.
+- The generated bridge debug log is stored in the local bridge runtime directory (for example `~/.aiyoperps/mcp-bridge/codex-debug.log` on Linux/WSL).
 - Before installation, the installer probes candidate MCP URLs and only writes config if it finds a reachable endpoint.

package/bin/aiyoperps-mcp-installer.js

@@ -16,6 +16,7 @@ const BRIDGE_SCRIPT_RELATIVE_PATH = path.join(
   'aiyoperps-mcp-bridge',
   'bin',
   'aiyoperps-mcp-bridge.js');
+const BRIDGE_DEBUG_LOG_NAME = 'codex-debug.log';
 const EXECUTABLE_CACHE = new Map();
 let bridgeRuntimePrepared = false;
 let bridgeRuntimeAttempted = false;
@@ -146,13 +147,23 @@ async function detectClaudeCode(url) {
 
 async function detectClaudeDesktop(url) {
   const candidates = getClaudeDesktopCandidates();
-  const configPath = candidates.find(fileExists) ?? candidates[0];
+  const configPath = candidates.find(fileExists) ??
+    candidates.find(candidate => fs.existsSync(path.dirname(candidate))) ??
+    candidates[0];
   const exists = fileExists(configPath);
   const parentExists = fs.existsSync(path.dirname(configPath));
-  const detected = exists || parentExists;
-  let supported = parentExists;
+  const baseConfigRoot = path.dirname(path.dirname(configPath));
+  const baseRootExists = fs.existsSync(baseConfigRoot);
+  const detected = exists || parentExists || baseRootExists;
+  let supported = baseRootExists;
   let installed = false;
-  let reason = detected ? 'ready for JSON config merge' : 'config directory not found';
+  let reason = exists
+    ? 'ready for JSON config merge'
+    : parentExists
+      ? 'ready for JSON config merge'
+      : baseRootExists
+        ? 'default config path can be created'
+        : 'config root not found';
 
   if (exists) {
     try {
@@ -570,9 +581,14 @@ async function resolveInstallUrl(defaultUrl, urlExplicit) {
 
   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) {
+    const result = await probeMcpEndpoint(candidate);
+    stdout.write(`  ${result.ok ? 'ok' : 'fail'} ${candidate}`);
+    if (!result.ok) {
+      const detail = result.stderr || result.stdout || result.error?.message || `exit=${result.status ?? 'unknown'}`;
+      stdout.write(` (${truncateText(detail, 180)})`);
+    }
+    stdout.write('\n');
+    if (result.ok) {
       return candidate;
     }
   }
@@ -617,8 +633,97 @@ async function canReachMcpEndpoint(url) {
   const commandLine = resolveCommandLineSpec(process.platform, url, {
     healthCheck: true
   });
-  const result = runCommand(commandLine.command, commandLine.args);
-  return result.ok;
+  return runCommand(commandLine.command, commandLine.args);
+}
+
+async function probeMcpEndpoint(url) {
+  const httpResult = await probeMcpEndpointHttp(url);
+  if (!httpResult.ok) {
+    return httpResult;
+  }
+
+  if (!bridgeRuntimePrepared && bridgeRuntimeAttempted) {
+    return httpResult;
+  }
+
+  const bridgeResult = await canReachMcpEndpoint(url);
+  if (!bridgeResult.ok) {
+    stdout.write(`  note bridge health check failed but HTTP MCP is reachable; continuing with ${url}\n`);
+  }
+
+  return httpResult;
+}
+
+async function probeMcpEndpointHttp(url) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 5000);
+
+  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
+    });
+
+    const text = await response.text();
+    if (!response.ok) {
+      return {
+        ok: false,
+        status: response.status,
+        stdout: '',
+        stderr: `HTTP ${response.status}: ${text || response.statusText}`
+      };
+    }
+
+    let payload;
+    try {
+      payload = JSON.parse(text);
+    } catch (error) {
+      return {
+        ok: false,
+        status: response.status,
+        stdout: '',
+        stderr: `Invalid JSON: ${error.message}`
+      };
+    }
+
+    if (payload?.error) {
+      return {
+        ok: false,
+        status: response.status,
+        stdout: '',
+        stderr: payload.error.message || 'JSON-RPC error'
+      };
+    }
+
+    return {
+      ok: true,
+      status: response.status,
+      stdout: '',
+      stderr: ''
+    };
+  } catch (error) {
+    const message = error?.name === 'AbortError'
+      ? 'Request timeout after 5000ms'
+      : error?.message || 'Unknown fetch error';
+    return {
+      ok: false,
+      status: null,
+      stdout: '',
+      stderr: message,
+      error
+    };
+  } finally {
+    clearTimeout(timeout);
+  }
 }
 
 function hasCodexBlock(content) {
@@ -775,7 +880,7 @@ function resolveCommandLineSpec(platform, url, options = {}) {
   } else if (options.healthCheck) {
     bridgeArgs.push('--health-check', '--quiet', '--url', url);
   } else {
-    bridgeArgs.push('--quiet', '--url', url);
+    bridgeArgs.push('--debug-log', resolveBridgeDebugLogPath(), '--quiet', '--url', url);
   }
 
   const installedScriptPath = resolveInstalledBridgeScriptPath();
@@ -801,6 +906,16 @@ function resolveCommandLineSpec(platform, url, options = {}) {
   };
 }
 
+function truncateText(value, maxLength) {
+  if (!value) {
+    return '';
+  }
+
+  return value.length <= maxLength
+    ? value
+    : `${value.slice(0, maxLength)}...`;
+}
+
 async function ensureBridgeRuntimePrepared() {
   if (bridgeRuntimeAttempted) {
     return bridgeRuntimePrepared;
@@ -864,6 +979,10 @@ function resolveInstalledBridgeScriptPath() {
   return fileExists(scriptPath) ? scriptPath : null;
 }
 
+function resolveBridgeDebugLogPath() {
+  return path.join(resolveBridgeInstallRoot(), BRIDGE_DEBUG_LOG_NAME);
+}
+
 function resolveCodexConfigPath() {
   if (env.CODEX_CONFIG_PATH) {
     return env.CODEX_CONFIG_PATH;

package/package.json

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