@bryan-thompson/inspector-assessment-cli 1.8.2 → 1.10.1

package/build/assess-full.js

@@ -40,6 +40,7 @@ function loadServerConfig(serverName, configPath) {
                 command: serverConfig.command,
                 args: serverConfig.args || [],
                 env: serverConfig.env || {},
+                cwd: serverConfig.cwd,
             };
         }
         if (config.url ||
@@ -129,6 +130,7 @@ function loadSourceFiles(sourcePath) {
  */
 async function connectToServer(config) {
     let transport;
+    let stderrData = ""; // Capture stderr for error reporting
     switch (config.transport) {
         case "http":
             if (!config.url)
@@ -151,8 +153,18 @@ async function connectToServer(config) {
                     ...Object.fromEntries(Object.entries(process.env).filter(([, v]) => v !== undefined)),
                     ...config.env,
                 },
+                cwd: config.cwd,
                 stderr: "pipe",
             });
+            // Capture stderr BEFORE connecting - critical for error context
+            // The MCP SDK creates a PassThrough stream immediately when stderr: "pipe"
+            // is set, allowing us to attach listeners before start() is called
+            const stderrStream = transport.stderr;
+            if (stderrStream) {
+                stderrStream.on("data", (data) => {
+                    stderrData += data.toString();
+                });
+            }
             break;
     }
     const client = new Client({
@@ -161,7 +173,22 @@ async function connectToServer(config) {
     }, {
         capabilities: {},
     });
-    await client.connect(transport);
+    try {
+        await client.connect(transport);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Provide helpful context when connection fails
+        if (stderrData.trim()) {
+            throw new Error(`Failed to connect to MCP server: ${errorMessage}\n\n` +
+                `Server stderr:\n${stderrData.trim()}\n\n` +
+                `Common causes:\n` +
+                `  - Missing environment variables (check .env file)\n` +
+                `  - Required external services not running\n` +
+                `  - Missing API credentials`);
+        }
+        throw new Error(`Failed to connect to MCP server: ${errorMessage}`);
+    }
     return client;
 }
 /**
@@ -251,15 +278,15 @@ async function runFullAssessment(options) {
     }
     const response = await client.listTools();
     const tools = response.tools || [];
+    // Always emit tool discovery events to stderr for audit-worker parsing
+    // Format: TOOL_DISCOVERED:name|description|param1,param2,... (works even with --json flag)
+    for (const tool of tools) {
+        const description = tool.description || "";
+        const params = Object.keys(tool.inputSchema?.properties || {}).join(",");
+        console.error(`TOOL_DISCOVERED:${tool.name}|${description}|${params}`);
+    }
     if (!options.jsonOnly) {
         console.log(`🔧 Found ${tools.length} tool${tools.length !== 1 ? "s" : ""}`);
-        // Output individual tools to stderr for early parsing by audit-worker
-        // Format: TOOL_DISCOVERED:name|description
-        // This enables MCP Auditor UI to show tools immediately after connection
-        for (const tool of tools) {
-            const description = tool.description || "";
-            console.error(`TOOL_DISCOVERED:${tool.name}|${description}`);
-        }
     }
     const config = buildConfig(options);
     const orchestrator = new AssessmentOrchestrator(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryan-thompson/inspector-assessment-cli",
-  "version": "1.8.2",
+  "version": "1.10.1",
   "description": "CLI for the Enhanced MCP Inspector with assessment capabilities",
   "license": "MIT",
   "author": "Bryan Thompson <bryan@triepod.ai>",