@mcpjam/inspector 0.3.8 → 0.8.0

package/cli/build/index.js

@@ -1,166 +0,0 @@
-#!/usr/bin/env node
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { Command } from "commander";
-import { callTool, connect, disconnect, getPrompt, listPrompts, listResources, listResourceTemplates, listTools, readResource, setLoggingLevel, validLogLevels, } from "./client/index.js";
-import { handleError } from "./error-handler.js";
-import { createTransport } from "./transport.js";
-function createTransportOptions(target) {
-    if (target.length === 0) {
-        throw new Error("Target is required. Specify a URL or a command to execute.");
-    }
-    const [command, ...commandArgs] = target;
-    if (!command) {
-        throw new Error("Command is required.");
-    }
-    const isUrl = command.startsWith("http://") || command.startsWith("https://");
-    if (isUrl && commandArgs.length > 0) {
-        throw new Error("Arguments cannot be passed to a URL-based MCP server.");
-    }
-    return {
-        transportType: isUrl ? "sse" : "stdio",
-        command: isUrl ? undefined : command,
-        args: isUrl ? undefined : commandArgs,
-        url: isUrl ? command : undefined,
-    };
-}
-async function callMethod(args) {
-    const transportOptions = createTransportOptions(args.target);
-    const transport = createTransport(transportOptions);
-    const client = new Client({
-        name: "inspector-cli",
-        version: "0.5.1",
-    });
-    try {
-        await connect(client, transport);
-        let result;
-        // Tools methods
-        if (args.method === "tools/list") {
-            result = await listTools(client);
-        }
-        else if (args.method === "tools/call") {
-            if (!args.toolName) {
-                throw new Error("Tool name is required for tools/call method. Use --tool-name to specify the tool name.");
-            }
-            result = await callTool(client, args.toolName, args.toolArg || {});
-        }
-        // Resources methods
-        else if (args.method === "resources/list") {
-            result = await listResources(client);
-        }
-        else if (args.method === "resources/read") {
-            if (!args.uri) {
-                throw new Error("URI is required for resources/read method. Use --uri to specify the resource URI.");
-            }
-            result = await readResource(client, args.uri);
-        }
-        else if (args.method === "resources/templates/list") {
-            result = await listResourceTemplates(client);
-        }
-        // Prompts methods
-        else if (args.method === "prompts/list") {
-            result = await listPrompts(client);
-        }
-        else if (args.method === "prompts/get") {
-            if (!args.promptName) {
-                throw new Error("Prompt name is required for prompts/get method. Use --prompt-name to specify the prompt name.");
-            }
-            result = await getPrompt(client, args.promptName, args.promptArgs || {});
-        }
-        // Logging methods
-        else if (args.method === "logging/setLevel") {
-            if (!args.logLevel) {
-                throw new Error("Log level is required for logging/setLevel method. Use --log-level to specify the log level.");
-            }
-            result = await setLoggingLevel(client, args.logLevel);
-        }
-        else {
-            throw new Error(`Unsupported method: ${args.method}. Supported methods include: tools/list, tools/call, resources/list, resources/read, resources/templates/list, prompts/list, prompts/get, logging/setLevel`);
-        }
-        console.log(JSON.stringify(result, null, 2));
-    }
-    finally {
-        try {
-            await disconnect(transport);
-        }
-        catch (disconnectError) {
-            throw disconnectError;
-        }
-    }
-}
-function parseKeyValuePair(value, previous = {}) {
-    const parts = value.split("=");
-    const key = parts[0];
-    const val = parts.slice(1).join("=");
-    if (val === undefined || val === "") {
-        throw new Error(`Invalid parameter format: ${value}. Use key=value format.`);
-    }
-    return { ...previous, [key]: val };
-}
-function parseArgs() {
-    const program = new Command();
-    // Find if there's a -- in the arguments and split them
-    const argSeparatorIndex = process.argv.indexOf("--");
-    let preArgs = process.argv;
-    let postArgs = [];
-    if (argSeparatorIndex !== -1) {
-        preArgs = process.argv.slice(0, argSeparatorIndex);
-        postArgs = process.argv.slice(argSeparatorIndex + 1);
-    }
-    program
-        .name("inspector-cli")
-        .allowUnknownOption()
-        .argument("<target...>", "Command and arguments or URL of the MCP server")
-        //
-        // Method selection
-        //
-        .option("--method <method>", "Method to invoke")
-        //
-        // Tool-related options
-        //
-        .option("--tool-name <toolName>", "Tool name (for tools/call method)")
-        .option("--tool-arg <pairs...>", "Tool argument as key=value pair", parseKeyValuePair, {})
-        //
-        // Resource-related options
-        //
-        .option("--uri <uri>", "URI of the resource (for resources/read method)")
-        //
-        // Prompt-related options
-        //
-        .option("--prompt-name <promptName>", "Name of the prompt (for prompts/get method)")
-        .option("--prompt-args <pairs...>", "Prompt arguments as key=value pairs", parseKeyValuePair, {})
-        //
-        // Logging options
-        //
-        .option("--log-level <level>", "Logging level (for logging/setLevel method)", (value) => {
-        if (!validLogLevels.includes(value)) {
-            throw new Error(`Invalid log level: ${value}. Valid levels are: ${validLogLevels.join(", ")}`);
-        }
-        return value;
-    });
-    // Parse only the arguments before --
-    program.parse(preArgs);
-    const options = program.opts();
-    let remainingArgs = program.args;
-    // Add back any arguments that came after --
-    const finalArgs = [...remainingArgs, ...postArgs];
-    if (!options.method) {
-        throw new Error("Method is required. Use --method to specify the method to invoke.");
-    }
-    return {
-        target: finalArgs,
-        ...options,
-    };
-}
-async function main() {
-    process.on("uncaughtException", (error) => {
-        handleError(error);
-    });
-    try {
-        const args = parseArgs();
-        await callMethod(args);
-    }
-    catch (error) {
-        handleError(error);
-    }
-}
-main();

package/cli/build/transport.js

@@ -1,47 +0,0 @@
-import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
-import { getDefaultEnvironment, StdioClientTransport, } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { findActualExecutable } from "spawn-rx";
-function createSSETransport(options) {
-    const baseUrl = new URL(options.url ?? "");
-    const sseUrl = new URL("/sse", baseUrl);
-    return new SSEClientTransport(sseUrl);
-}
-function createStdioTransport(options) {
-    let args = [];
-    if (options.args !== undefined) {
-        args = options.args;
-    }
-    const processEnv = {};
-    for (const [key, value] of Object.entries(process.env)) {
-        if (value !== undefined) {
-            processEnv[key] = value;
-        }
-    }
-    const defaultEnv = getDefaultEnvironment();
-    const env = {
-        ...processEnv,
-        ...defaultEnv,
-    };
-    const { cmd: actualCommand, args: actualArgs } = findActualExecutable(options.command ?? "", args);
-    return new StdioClientTransport({
-        command: actualCommand,
-        args: actualArgs,
-        env,
-        stderr: "pipe",
-    });
-}
-export function createTransport(options) {
-    const { transportType } = options;
-    try {
-        if (transportType === "stdio") {
-            return createStdioTransport(options);
-        }
-        if (transportType === "sse") {
-            return createSSETransport(options);
-        }
-        throw new Error(`Unsupported transport type: ${transportType}`);
-    }
-    catch (error) {
-        throw new Error(`Failed to create transport: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}

package/client/bin/client.js

@@ -1,71 +0,0 @@
-#!/usr/bin/env node
-
-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");
-
-const server = http.createServer((request, response) => {
-  const handlerOptions = {
-    public: distPath,
-    rewrites: [{ source: "/**", destination: "/index.html" }],
-    headers: [
-      {
-        // Ensure index.html is never cached
-        source: "index.html",
-        headers: [
-          {
-            key: "Cache-Control",
-            value: "no-cache, no-store, max-age=0",
-          },
-        ],
-      },
-      {
-        // Allow long-term caching for hashed assets
-        source: "assets/**",
-        headers: [
-          {
-            key: "Cache-Control",
-            value: "public, max-age=31536000, immutable",
-          },
-        ],
-      },
-    ],
-  };
-
-  return handler(request, response, handlerOptions);
-});
-
-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 \u001B]8;;${url}\u0007${url}\u001B]8;;\u0007 🚀`,
-  );
-
-  if (process.env.MCP_AUTO_OPEN_ENABLED !== "false") {
-    console.log(
-      `🌐 Opening browser at \u001B]8;;${url}\u0007${url}\u001B]8;;\u0007`,
-    );
-    open(url);
-  }
-});
-
-server.listen(port);

package/client/bin/start.js

@@ -1,143 +0,0 @@
-#!/usr/bin/env node
-
-import { resolve, dirname } from "path";
-import { spawnPromise } from "spawn-rx";
-import { fileURLToPath } from "url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-const MCP_BANNER = `
-███╗   ███╗ ██████╗██████╗     ██╗ █████╗ ███╗   ███╗
-████╗ ████║██╔════╝██╔══██╗    ██║██╔══██╗████╗ ████║
-██╔████╔██║██║     ██████╔╝    ██║███████║██╔████╔██║
-██║╚██╔╝██║██║     ██╔═══╝██   ██║██╔══██║██║╚██╔╝██║
-██║ ╚═╝ ██║╚██████╗██║    ╚█████╔╝██║  ██║██║ ╚═╝ ██║
-╚═╝     ╚═╝ ╚═════╝╚═╝     ╚════╝ ╚═╝  ╚═╝╚═╝     ╚═╝                                                    
-`;
-
-function delay(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms, true));
-}
-
-async function main() {
-  // Clear console and display banner
-  console.clear();
-  console.log("\x1b[36m%s\x1b[0m", MCP_BANNER); // Cyan color
-  console.log("\x1b[33m%s\x1b[0m", "🚀 Launching MCP Inspector...\n"); // Yellow color
-
-  // Parse command line arguments
-  const args = process.argv.slice(2);
-  const envVars = {};
-  const mcpServerArgs = [];
-  let command = null;
-  let parsingFlags = true;
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (parsingFlags && arg === "--") {
-      parsingFlags = false;
-      continue;
-    }
-
-    if (parsingFlags && arg === "-e" && i + 1 < args.length) {
-      const envVar = args[++i];
-      const equalsIndex = envVar.indexOf("=");
-
-      if (equalsIndex !== -1) {
-        const key = envVar.substring(0, equalsIndex);
-        const value = envVar.substring(equalsIndex + 1);
-        envVars[key] = value;
-      } else {
-        envVars[envVar] = "";
-      }
-    } else if (!command) {
-      command = arg;
-    } else {
-      mcpServerArgs.push(arg);
-    }
-  }
-
-  const inspectorServerPath = resolve(
-    __dirname,
-    "../..",
-    "server",
-    "build",
-    "index.js",
-  );
-
-  // Path to the client entry point
-  const inspectorClientPath = resolve(
-    __dirname,
-    "../..",
-    "client",
-    "bin",
-    "client.js",
-  );
-
-  const CLIENT_PORT = process.env.CLIENT_PORT ?? "6274";
-  const SERVER_PORT = process.env.SERVER_PORT ?? "6277";
-
-  const abort = new AbortController();
-
-  let cancelled = false;
-  process.on("SIGINT", () => {
-    cancelled = true;
-    abort.abort();
-    console.log("\n\x1b[31m%s\x1b[0m", "⚠️  Shutting down MCP Inspector..."); // Red color
-  });
-
-  let server, serverOk;
-  try {
-    server = spawnPromise(
-      "node",
-      [
-        inspectorServerPath,
-        ...(command ? [`--env`, command] : []),
-        ...(mcpServerArgs ? [`--args=${mcpServerArgs.join(" ")}`] : []),
-      ],
-      {
-        env: {
-          ...process.env,
-          PORT: SERVER_PORT,
-          MCP_ENV_VARS: JSON.stringify(envVars),
-        },
-        signal: abort.signal,
-        echoOutput: true,
-      },
-    );
-
-    // Make sure server started before starting client
-    serverOk = await Promise.race([server, delay(2 * 1000)]);
-  } catch (error) {
-    console.log("\x1b[31m%s\x1b[0m", "❌ Server initialization failed"); // Red color
-  }
-
-  if (serverOk) {
-    try {
-      console.log("\x1b[32m%s\x1b[0m", "✅ Server initialized successfully"); // Green color
-      console.log("\x1b[33m%s\x1b[0m", "🖥️  Starting client interface...");
-
-      await spawnPromise("node", [inspectorClientPath], {
-        env: {
-          ...process.env,
-          PORT: CLIENT_PORT,
-          MCP_AUTO_OPEN_ENABLED: process.env.MCP_AUTO_OPEN_ENABLED ?? "true",
-        },
-        signal: abort.signal,
-        echoOutput: true,
-      });
-    } catch (e) {
-      if (!cancelled || process.env.DEBUG) throw e;
-    }
-  }
-
-  return 0;
-}
-
-main()
-  .then((_) => process.exit(0))
-  .catch((e) => {
-    console.error("\x1b[31m%s\x1b[0m", "❌ Error:", e); // Red color
-    process.exit(1);
-  });

package/client/dist/assets/OAuthCallback-Dovy-wwC.js

@@ -1,56 +0,0 @@
-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-DTD8_Uq7.js";
-const OAuthCallback = ({ onConnect }) => {
-  const { toast } = useToast();
-  const hasProcessedRef = reactExports.useRef(false);
-  reactExports.useEffect(() => {
-    const handleCallback = async () => {
-      if (hasProcessedRef.current) {
-        return;
-      }
-      hasProcessedRef.current = true;
-      const notifyError = (description) => void toast({
-        title: "OAuth Authorization Error",
-        description,
-        variant: "destructive"
-      });
-      const params = parseOAuthCallbackParams(window.location.search);
-      if (!params.successful) {
-        return notifyError(generateOAuthErrorDescription(params));
-      }
-      const serverUrl = sessionStorage.getItem(SESSION_KEYS.SERVER_URL);
-      if (!serverUrl) {
-        return notifyError("Missing Server URL");
-      }
-      let result;
-      try {
-        const serverAuthProvider = new InspectorOAuthClientProvider(serverUrl);
-        result = await auth(serverAuthProvider, {
-          serverUrl,
-          authorizationCode: params.code
-        });
-      } catch (error) {
-        console.error("OAuth callback error:", error);
-        return notifyError(`Unexpected error occurred: ${error}`);
-      }
-      if (result !== "AUTHORIZED") {
-        return notifyError(
-          `Expected to be authorized after providing auth code, got: ${result}`
-        );
-      }
-      toast({
-        title: "Success",
-        description: "Successfully authenticated with OAuth",
-        variant: "default"
-      });
-      onConnect(serverUrl);
-    };
-    handleCallback().finally(() => {
-      sessionStorage.removeItem(SESSION_KEYS.TRANSPORT_TYPE);
-      window.history.replaceState({}, document.title, "/");
-    });
-  }, [toast, onConnect]);
-  return /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "flex items-center justify-center h-screen", children: /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "text-lg text-gray-500", children: "Processing OAuth callback..." }) });
-};
-export {
-  OAuthCallback as default
-};

package/client/dist/assets/OAuthDebugCallback-CP9EZ76u.js

@@ -1,44 +0,0 @@
-import { r as reactExports, S as SESSION_KEYS, p as parseOAuthCallbackParams, j as jsxRuntimeExports, g as generateOAuthErrorDescription } from "./index-DTD8_Uq7.js";
-const OAuthDebugCallback = ({ onConnect }) => {
-  reactExports.useEffect(() => {
-    let isProcessed = false;
-    const handleCallback = async () => {
-      if (isProcessed) {
-        return;
-      }
-      isProcessed = true;
-      const params = parseOAuthCallbackParams(window.location.search);
-      if (!params.successful) {
-        const errorMsg = generateOAuthErrorDescription(params);
-        onConnect({ errorMsg });
-        return;
-      }
-      const serverUrl = sessionStorage.getItem(SESSION_KEYS.SERVER_URL);
-      if (!serverUrl) {
-        return;
-      }
-      if (!params.code) {
-        onConnect({ errorMsg: "Missing authorization code" });
-        return;
-      }
-      onConnect({ authorizationCode: params.code });
-    };
-    handleCallback().finally(() => {
-      if (sessionStorage.getItem(SESSION_KEYS.SERVER_URL)) {
-        window.history.replaceState({}, document.title, "/");
-      }
-    });
-    return () => {
-      isProcessed = true;
-    };
-  }, [onConnect]);
-  const callbackParams = parseOAuthCallbackParams(window.location.search);
-  return /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "flex items-center justify-center h-screen", children: /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "mt-4 p-4 bg-secondary rounded-md max-w-md", children: [
-    /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "mb-2 text-sm", children: "Please copy this authorization code and return to the Auth Debugger:" }),
-    /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "block p-2 bg-muted rounded-sm overflow-x-auto text-xs", children: callbackParams.successful && "code" in callbackParams ? callbackParams.code : `No code found: ${callbackParams.error}, ${callbackParams.error_description}` }),
-    /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "mt-4 text-xs text-muted-foreground", children: "Close this tab and paste the code in the OAuth flow to complete authentication." })
-  ] }) });
-};
-export {
-  OAuthDebugCallback as default
-};