@mcpjam/inspector 0.3.4 → 0.3.6

package/README.md

@@ -14,6 +14,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@mcpjam/inspector?style=for-the-badge&color=blue)](https://www.npmjs.com/package/@mcpjam/inspector)
 [![npm downloads](https://img.shields.io/npm/dm/@mcpjam/inspector?style=for-the-badge&color=green)](https://www.npmjs.com/package/@mcpjam/inspector)
+[![Docker Pulls](https://img.shields.io/docker/pulls/mcpjam/mcp-inspector?style=for-the-badge)](https://hub.docker.com/r/mcpjam/mcp-inspector)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](https://opensource.org/licenses/Apache-2.0)
 [![Node.js](https://img.shields.io/badge/Node.js-22.7.5+-green.svg?style=for-the-badge&logo=node.js)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.8+-blue.svg?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)

package/cli/build/cli.js

@@ -60,6 +60,9 @@ async function runWebClient(args) {
                 ...process.env,
                 PORT: SERVER_PORT,
                 MCP_ENV_VARS: JSON.stringify(args.envArgs),
+                MCP_SERVER_CONFIGS: args.serverConfigs
+                    ? JSON.stringify(args.serverConfigs)
+                    : undefined,
             },
             signal: abort.signal,
             echoOutput: true,
@@ -73,15 +76,13 @@ async function runWebClient(args) {
     if (serverOk) {
         try {
             console.log("\x1b[32m%s\x1b[0m", "✅ Server initialized successfully"); // Green color
-            console.log("\x1b[36m%s\x1b[0m", `🌐 Opening browser at http://127.0.0.1:${CLIENT_PORT}`);
-            if (process.env.MCP_AUTO_OPEN_ENABLED !== "false") {
-                // Note: We need to import 'open' if we want to auto-open browser
-                // import open from "open";
-                // open(`http://127.0.0.1:${CLIENT_PORT}`);
-            }
             console.log("\x1b[33m%s\x1b[0m", "🖥️  Starting client interface...");
             await spawnPromise("node", [inspectorClientPath], {
-                env: { ...process.env, PORT: CLIENT_PORT },
+                env: {
+                    ...process.env,
+                    PORT: CLIENT_PORT,
+                    MCP_AUTO_OPEN_ENABLED: process.env.MCP_AUTO_OPEN_ENABLED ?? "true",
+                },
                 signal: abort.signal,
                 echoOutput: true,
             });
@@ -138,6 +139,28 @@ function loadConfigFile(configPath, serverName) {
         throw err;
     }
 }
+function loadAllServersFromConfig(configPath) {
+    try {
+        const resolvedConfigPath = path.isAbsolute(configPath)
+            ? configPath
+            : path.resolve(process.cwd(), configPath);
+        if (!fs.existsSync(resolvedConfigPath)) {
+            throw new Error(`Config file not found: ${resolvedConfigPath}`);
+        }
+        const configContent = fs.readFileSync(resolvedConfigPath, "utf8");
+        const parsedConfig = JSON.parse(configContent);
+        if (!parsedConfig.mcpServers) {
+            throw new Error("No 'mcpServers' section found in config file");
+        }
+        return parsedConfig.mcpServers;
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in config file: ${err.message}`);
+        }
+        throw err;
+    }
+}
 function parseKeyValuePair(value, previous = {}) {
     const parts = value.split("=");
     const key = parts[0];
@@ -170,22 +193,33 @@ function parseArgs() {
     const remainingArgs = program.args;
     // Add back any arguments that came after --
     const finalArgs = [...remainingArgs, ...postArgs];
-    // Validate that config and server are provided together
-    if ((options.config && !options.server) ||
-        (!options.config && options.server)) {
-        throw new Error("Both --config and --server must be provided together. If you specify one, you must specify the other.");
-    }
-    // If config file is specified, load and use the options from the file. We must merge the args
-    // from the command line and the file together, or we will miss the method options (--method,
-    // etc.)
-    if (options.config && options.server) {
-        const config = loadConfigFile(options.config, options.server);
-        return {
-            command: config.command,
-            args: [...(config.args || []), ...finalArgs],
-            envArgs: { ...(config.env || {}), ...(options.e || {}) },
-            cli: options.cli || false,
-        };
+    // Validate server option
+    if (!options.config && options.server) {
+        throw new Error("--server option requires --config to be specified.");
+    }
+    // If config file is specified
+    if (options.config) {
+        if (options.server) {
+            // Single server mode: load specific server from config
+            const config = loadConfigFile(options.config, options.server);
+            return {
+                command: config.command,
+                args: [...(config.args || []), ...finalArgs],
+                envArgs: { ...(config.env || {}), ...(options.e || {}) },
+                cli: options.cli || false,
+            };
+        }
+        else {
+            // Multiple servers mode: load all servers from config
+            const serverConfigs = loadAllServersFromConfig(options.config);
+            return {
+                command: "", // No single command in multi-server mode
+                args: finalArgs,
+                envArgs: options.e || {},
+                cli: options.cli || false,
+                serverConfigs,
+            };
+        }
     }
     // Otherwise use command line arguments
     const command = finalArgs[0] || "";

package/client/bin/client.js

@@ -4,6 +4,7 @@ import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import handler from "serve-handler";
 import http from "http";
+import open from "open";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const distPath = join(__dirname, "../dist");
@@ -39,19 +40,32 @@ const server = http.createServer((request, response) => {
   return handler(request, response, handlerOptions);
 });
 
-const port = process.env.PORT || 6274;
+const defaultPort = process.env.PORT || 6274;
+let port = Number(defaultPort);
+
+// Try ports sequentially until one works
+server.on("error", (err) => {
+  if (err.code === "EADDRINUSE") {
+    console.log(`⚠️  Port ${port} was in use, trying ${port + 1}`);
+    port++;
+    server.listen(port);
+  } else {
+    console.error(`❌  MCPJam Inspector failed to start: ${err.message}`);
+  }
+});
+
 server.on("listening", () => {
+  const url = `http://127.0.0.1:${port}`;
   console.log(
-    `🔍 MCPJam Inspector is up and running at http://127.0.0.1:${port} 🚀`,
+    `🔍 MCPJam Inspector is up and running at \u001B]8;;${url}\u0007${url}\u001B]8;;\u0007 🚀`,
   );
-});
-server.on("error", (err) => {
-  if (err.message.includes(`EADDRINUSE`)) {
-    console.error(
-      `❌  MCPJam Inspector PORT IS IN USE at http://127.0.0.1:${port} ❌ `,
+
+  if (process.env.MCP_AUTO_OPEN_ENABLED !== "false") {
+    console.log(
+      `🌐 Opening browser at \u001B]8;;${url}\u0007${url}\u001B]8;;\u0007`,
     );
-  } else {
-    throw err;
+    open(url);
   }
 });
+
 server.listen(port);

package/client/bin/start.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 
-import open from "open";
 import { resolve, dirname } from "path";
 import { spawnPromise } from "spawn-rx";
 import { fileURLToPath } from "url";
@@ -87,6 +86,7 @@ async function main() {
     abort.abort();
     console.log("\n\x1b[31m%s\x1b[0m", "⚠️  Shutting down MCP Inspector..."); // Red color
   });
+
   let server, serverOk;
   try {
     server = spawnPromise(
@@ -116,19 +116,14 @@ async function main() {
   if (serverOk) {
     try {
       console.log("\x1b[32m%s\x1b[0m", "✅ Server initialized successfully"); // Green color
-      console.log(
-        "\x1b[36m%s\x1b[0m",
-        `🌐 Opening browser at http://127.0.0.1:${CLIENT_PORT}`,
-      );
-
-      if (process.env.MCP_AUTO_OPEN_ENABLED !== "false") {
-        open(`http://127.0.0.1:${CLIENT_PORT}`);
-      }
-
       console.log("\x1b[33m%s\x1b[0m", "🖥️  Starting client interface...");
 
       await spawnPromise("node", [inspectorClientPath], {
-        env: { ...process.env, PORT: CLIENT_PORT },
+        env: {
+          ...process.env,
+          PORT: CLIENT_PORT,
+          MCP_AUTO_OPEN_ENABLED: process.env.MCP_AUTO_OPEN_ENABLED ?? "true",
+        },
         signal: abort.signal,
         echoOutput: true,
       });

package/client/dist/assets/{OAuthCallback-59IQqASq.js → OAuthCallback-Bgz6lAmx.js}

@@ -1,4 +1,4 @@
-import { u as useToast, r as reactExports, j as jsxRuntimeExports, p as parseOAuthCallbackParams, g as generateOAuthErrorDescription, S as SESSION_KEYS, I as InspectorOAuthClientProvider, a as auth } from "./index-B_8Xm9gw.js";
+import { u as useToast, r as reactExports, S as SESSION_KEYS, j as jsxRuntimeExports, p as parseOAuthCallbackParams, g as generateOAuthErrorDescription, I as InspectorOAuthClientProvider, a as auth } from "./index-Bgrnc5s2.js";
 const OAuthCallback = ({ onConnect }) => {
   const { toast } = useToast();
   const hasProcessedRef = reactExports.useRef(false);
@@ -45,6 +45,7 @@ const OAuthCallback = ({ onConnect }) => {
       onConnect(serverUrl);
     };
     handleCallback().finally(() => {
+      sessionStorage.removeItem(SESSION_KEYS.TRANSPORT_TYPE);
       window.history.replaceState({}, document.title, "/");
     });
   }, [toast, onConnect]);

package/client/dist/assets/{OAuthDebugCallback-Bm010sVQ.js → OAuthDebugCallback-Gd08QO37.js}

@@ -1,4 +1,4 @@
-import { r as reactExports, S as SESSION_KEYS, p as parseOAuthCallbackParams, j as jsxRuntimeExports, g as generateOAuthErrorDescription } from "./index-B_8Xm9gw.js";
+import { r as reactExports, S as SESSION_KEYS, p as parseOAuthCallbackParams, j as jsxRuntimeExports, g as generateOAuthErrorDescription } from "./index-Bgrnc5s2.js";
 const OAuthDebugCallback = ({ onConnect }) => {
   reactExports.useEffect(() => {
     let isProcessed = false;