@mcp-use/inspector 0.3.11 → 0.4.0

package/dist/cli/cli/inspect.js

@@ -1,262 +0,0 @@
-#!/usr/bin/env node
-import { serve } from '@hono/node-server';
-import { Hono } from 'hono';
-import { cors } from 'hono/cors';
-import { logger } from 'hono/logger';
-import { existsSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-import { MCPInspector } from '../server/mcp-inspector.js';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const execAsync = promisify(exec);
-// Find available port starting from 8080
-async function findAvailablePort(startPort = 8080) {
-    const net = await import('node:net');
-    for (let port = startPort; port < startPort + 100; port++) {
-        try {
-            await new Promise((resolve, reject) => {
-                const server = net.createServer();
-                server.listen(port, () => {
-                    server.close(() => resolve());
-                });
-                server.on('error', () => reject(new Error(`Port ${port} is in use`)));
-            });
-            return port;
-        }
-        catch {
-            continue;
-        }
-    }
-    throw new Error(`No available port found starting from ${startPort}`);
-}
-// Parse command line arguments
-const args = process.argv.slice(2);
-let mcpUrl;
-let startPort = 8080;
-for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--url' && i + 1 < args.length) {
-        mcpUrl = args[i + 1];
-        i++;
-    }
-    else if (args[i] === '--port' && i + 1 < args.length) {
-        startPort = parseInt(args[i + 1], 10);
-        i++;
-    }
-    else if (args[i] === '--help' || args[i] === '-h') {
-        console.log(`
-MCP Inspector - Inspect and debug MCP servers
-
-Usage:
-  npx @mcp-use/inspect [options]
-
-Options:
-  --url <url>    MCP server URL to auto-connect to (e.g., http://localhost:3000/mcp)
-  --port <port>  Starting port to try (default: 8080, will find next available)
-  --help, -h     Show this help message
-
-Examples:
-  # Run inspector with auto-connect
-  npx @mcp-use/inspect --url http://localhost:3000/mcp
-
-  # Run starting from custom port
-  npx @mcp-use/inspect --url http://localhost:3000/mcp --port 9000
-
-  # Run without auto-connect
-  npx @mcp-use/inspect
-`);
-        process.exit(0);
-    }
-}
-const app = new Hono();
-// Middleware
-app.use('*', cors());
-app.use('*', logger());
-// Health check
-app.get('/health', (c) => {
-    return c.json({ status: 'ok', timestamp: new Date().toISOString() });
-});
-// MCP Inspector routes
-const mcpInspector = new MCPInspector();
-// List available MCP servers
-app.get('/api/servers', async (c) => {
-    try {
-        const servers = await mcpInspector.listServers();
-        return c.json({ servers });
-    }
-    catch {
-        return c.json({ error: 'Failed to list servers' }, 500);
-    }
-});
-// Connect to an MCP server
-app.post('/api/servers/connect', async (c) => {
-    try {
-        const { url, command } = await c.req.json();
-        const server = await mcpInspector.connectToServer(url, command);
-        return c.json({ server });
-    }
-    catch {
-        return c.json({ error: 'Failed to connect to server' }, 500);
-    }
-});
-// Get server details
-app.get('/api/servers/:id', async (c) => {
-    try {
-        const id = c.req.param('id');
-        const server = await mcpInspector.getServer(id);
-        if (!server) {
-            return c.json({ error: 'Server not found' }, 404);
-        }
-        return c.json({ server });
-    }
-    catch {
-        return c.json({ error: 'Failed to get server details' }, 500);
-    }
-});
-// Execute a tool on a server
-app.post('/api/servers/:id/tools/:toolName/execute', async (c) => {
-    try {
-        const id = c.req.param('id');
-        const toolName = c.req.param('toolName');
-        const input = await c.req.json();
-        const result = await mcpInspector.executeTool(id, toolName, input);
-        return c.json({ result });
-    }
-    catch {
-        return c.json({ error: 'Failed to execute tool' }, 500);
-    }
-});
-// Get server tools
-app.get('/api/servers/:id/tools', async (c) => {
-    try {
-        const id = c.req.param('id');
-        const tools = await mcpInspector.getServerTools(id);
-        return c.json({ tools });
-    }
-    catch {
-        return c.json({ error: 'Failed to get server tools' }, 500);
-    }
-});
-// Get server resources
-app.get('/api/servers/:id/resources', async (c) => {
-    try {
-        const id = c.req.param('id');
-        const resources = await mcpInspector.getServerResources(id);
-        return c.json({ resources });
-    }
-    catch {
-        return c.json({ error: 'Failed to get server resources' }, 500);
-    }
-});
-// Disconnect from a server
-app.delete('/api/servers/:id', async (c) => {
-    try {
-        const id = c.req.param('id');
-        await mcpInspector.disconnectServer(id);
-        return c.json({ success: true });
-    }
-    catch {
-        return c.json({ error: 'Failed to disconnect server' }, 500);
-    }
-});
-// Serve static assets from the built client
-const clientDistPath = join(__dirname, '../../dist/client');
-if (existsSync(clientDistPath)) {
-    // Serve static assets from /inspector/assets/* (matching Vite's base path)
-    app.get('/inspector/assets/*', async (c) => {
-        const path = c.req.path.replace('/inspector/assets/', 'assets/');
-        const fullPath = join(clientDistPath, path);
-        if (existsSync(fullPath)) {
-            const content = await import('node:fs').then(fs => fs.readFileSync(fullPath));
-            // Set appropriate content type based on file extension
-            if (path.endsWith('.js')) {
-                c.header('Content-Type', 'application/javascript');
-            }
-            else if (path.endsWith('.css')) {
-                c.header('Content-Type', 'text/css');
-            }
-            else if (path.endsWith('.svg')) {
-                c.header('Content-Type', 'image/svg+xml');
-            }
-            return c.body(content);
-        }
-        return c.notFound();
-    });
-    // Redirect root path to /inspector
-    app.get('/', (c) => {
-        return c.redirect('/inspector');
-    });
-    // Serve the main HTML file for /inspector and all other routes (SPA routing)
-    app.get('*', (c) => {
-        const indexPath = join(clientDistPath, 'index.html');
-        if (existsSync(indexPath)) {
-            const content = import('node:fs').then(fs => fs.readFileSync(indexPath, 'utf-8'));
-            return c.html(content);
-        }
-        return c.html(`
-      <!DOCTYPE html>
-      <html>
-        <head>
-          <title>MCP Inspector</title>
-        </head>
-        <body>
-          <h1>MCP Inspector</h1>
-          <p>Client files not found. Please run 'yarn build' to build the UI.</p>
-          <p>API is available at <a href="/api/servers">/api/servers</a></p>
-        </body>
-      </html>
-    `);
-    });
-}
-else {
-    console.warn(`⚠️  MCP Inspector client files not found at ${clientDistPath}`);
-    console.warn(`   Run 'yarn build' in the inspector package to build the UI`);
-    // Fallback for when client is not built
-    app.get('*', (c) => {
-        return c.html(`
-      <!DOCTYPE html>
-      <html>
-        <head>
-          <title>MCP Inspector</title>
-        </head>
-        <body>
-          <h1>MCP Inspector</h1>
-          <p>Client files not found. Please run 'yarn build' to build the UI.</p>
-          <p>API is available at <a href="/api/servers">/api/servers</a></p>
-        </body>
-      </html>
-    `);
-    });
-}
-// Start the server with automatic port selection
-async function startServer() {
-    try {
-        const port = await findAvailablePort(startPort);
-        serve({
-            fetch: app.fetch,
-            port,
-        });
-        console.log(`🚀 MCP Inspector running on http://localhost:${port}`);
-        if (mcpUrl) {
-            console.log(`📡 Auto-connecting to: ${mcpUrl}`);
-        }
-        // Auto-open browser
-        try {
-            const command = process.platform === 'win32' ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open';
-            await execAsync(`${command} http://localhost:${port}`);
-            console.log(`🌐 Browser opened automatically`);
-        }
-        catch (error) {
-            console.log(`🌐 Please open http://localhost:${port} in your browser`);
-        }
-        return { port, fetch: app.fetch };
-    }
-    catch (error) {
-        console.error('Failed to start server:', error);
-        process.exit(1);
-    }
-}
-// Start the server
-startServer();

package/dist/cli/inspect.cjs

@@ -1,372 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-
-// src/cli/inspect.ts
-var import_node_server = require("@hono/node-server");
-var import_hono = require("hono");
-var import_cors = require("hono/cors");
-var import_logger = require("hono/logger");
-var import_node_fs = require("fs");
-var import_node_path = require("path");
-var import_node_url = require("url");
-var import_node_child_process = require("child_process");
-var import_node_util = require("util");
-
-// src/server/mcp-inspector.ts
-var import_mcp_use = require("mcp-use");
-var MCPInspector = class {
-  constructor() {
-    __publicField(this, "servers", /* @__PURE__ */ new Map());
-    __publicField(this, "client");
-    this.client = new import_mcp_use.MCPClient();
-  }
-  async listServers() {
-    return Array.from(this.servers.values());
-  }
-  async connectToServer(url, command) {
-    const id = Date.now().toString();
-    const name = url || command || "Unknown Server";
-    try {
-      const serverName = `server_${id}`;
-      const serverConfig = url ? { url } : { command };
-      this.client.addServer(serverName, serverConfig);
-      const session = await this.client.createSession(serverName, true);
-      const tools = [
-        {
-          name: "get_weather",
-          description: "Get current weather for a location",
-          inputSchema: {
-            type: "object",
-            properties: {
-              location: { type: "string", description: "City name" }
-            },
-            required: ["location"]
-          }
-        }
-      ];
-      const resources = [
-        {
-          uri: "file:///home/user/documents",
-          name: "Documents",
-          description: "User documents directory",
-          mimeType: "application/x-directory"
-        }
-      ];
-      const server = {
-        id,
-        name,
-        url,
-        command,
-        status: "connected",
-        session,
-        tools,
-        resources,
-        lastActivity: /* @__PURE__ */ new Date()
-      };
-      this.servers.set(id, server);
-      return server;
-    } catch (error) {
-      const server = {
-        id,
-        name,
-        url,
-        command,
-        status: "error",
-        tools: [],
-        resources: [],
-        lastActivity: /* @__PURE__ */ new Date()
-      };
-      this.servers.set(id, server);
-      throw error;
-    }
-  }
-  async getServer(id) {
-    return this.servers.get(id) || null;
-  }
-  async executeTool(serverId, toolName, input) {
-    const server = this.servers.get(serverId);
-    if (!server || !server.session) {
-      throw new Error("Server not found or not connected");
-    }
-    try {
-      const result = {
-        tool: toolName,
-        input,
-        result: `Mock result for ${toolName} with input: ${JSON.stringify(input)}`,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
-      };
-      server.lastActivity = /* @__PURE__ */ new Date();
-      return result;
-    } catch (error) {
-      server.status = "error";
-      throw error;
-    }
-  }
-  async getServerTools(serverId) {
-    const server = this.servers.get(serverId);
-    if (!server) {
-      throw new Error("Server not found");
-    }
-    return server.tools;
-  }
-  async getServerResources(serverId) {
-    const server = this.servers.get(serverId);
-    if (!server) {
-      throw new Error("Server not found");
-    }
-    return server.resources;
-  }
-  async disconnectServer(serverId) {
-    const server = this.servers.get(serverId);
-    if (server && server.session) {
-      try {
-        await server.session.disconnect();
-      } catch (error) {
-        console.error("Error disconnecting from server:", error);
-      }
-    }
-    this.servers.delete(serverId);
-  }
-};
-
-// src/cli/inspect.ts
-var import_meta = {};
-var __filename = (0, import_node_url.fileURLToPath)(import_meta.url);
-var __dirname = (0, import_node_path.dirname)(__filename);
-var execAsync = (0, import_node_util.promisify)(import_node_child_process.exec);
-async function findAvailablePort(startPort2 = 8080) {
-  const net = await import("net");
-  for (let port = startPort2; port < startPort2 + 100; port++) {
-    try {
-      await new Promise((resolve, reject) => {
-        const server = net.createServer();
-        server.listen(port, () => {
-          server.close(() => resolve());
-        });
-        server.on("error", () => reject(new Error(`Port ${port} is in use`)));
-      });
-      return port;
-    } catch {
-      continue;
-    }
-  }
-  throw new Error(`No available port found starting from ${startPort2}`);
-}
-var args = process.argv.slice(2);
-var mcpUrl;
-var startPort = 8080;
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === "--url" && i + 1 < args.length) {
-    mcpUrl = args[i + 1];
-    i++;
-  } else if (args[i] === "--port" && i + 1 < args.length) {
-    startPort = parseInt(args[i + 1], 10);
-    i++;
-  } else if (args[i] === "--help" || args[i] === "-h") {
-    console.log(`
-MCP Inspector - Inspect and debug MCP servers
-
-Usage:
-  npx @mcp-use/inspect [options]
-
-Options:
-  --url <url>    MCP server URL to auto-connect to (e.g., http://localhost:3000/mcp)
-  --port <port>  Starting port to try (default: 8080, will find next available)
-  --help, -h     Show this help message
-
-Examples:
-  # Run inspector with auto-connect
-  npx @mcp-use/inspect --url http://localhost:3000/mcp
-
-  # Run starting from custom port
-  npx @mcp-use/inspect --url http://localhost:3000/mcp --port 9000
-
-  # Run without auto-connect
-  npx @mcp-use/inspect
-`);
-    process.exit(0);
-  }
-}
-var app = new import_hono.Hono();
-app.use("*", (0, import_cors.cors)());
-app.use("*", (0, import_logger.logger)());
-app.get("/health", (c) => {
-  return c.json({ status: "ok", timestamp: (/* @__PURE__ */ new Date()).toISOString() });
-});
-var mcpInspector = new MCPInspector();
-app.get("/api/servers", async (c) => {
-  try {
-    const servers = await mcpInspector.listServers();
-    return c.json({ servers });
-  } catch {
-    return c.json({ error: "Failed to list servers" }, 500);
-  }
-});
-app.post("/api/servers/connect", async (c) => {
-  try {
-    const { url, command } = await c.req.json();
-    const server = await mcpInspector.connectToServer(url, command);
-    return c.json({ server });
-  } catch {
-    return c.json({ error: "Failed to connect to server" }, 500);
-  }
-});
-app.get("/api/servers/:id", async (c) => {
-  try {
-    const id = c.req.param("id");
-    const server = await mcpInspector.getServer(id);
-    if (!server) {
-      return c.json({ error: "Server not found" }, 404);
-    }
-    return c.json({ server });
-  } catch {
-    return c.json({ error: "Failed to get server details" }, 500);
-  }
-});
-app.post("/api/servers/:id/tools/:toolName/execute", async (c) => {
-  try {
-    const id = c.req.param("id");
-    const toolName = c.req.param("toolName");
-    const input = await c.req.json();
-    const result = await mcpInspector.executeTool(id, toolName, input);
-    return c.json({ result });
-  } catch {
-    return c.json({ error: "Failed to execute tool" }, 500);
-  }
-});
-app.get("/api/servers/:id/tools", async (c) => {
-  try {
-    const id = c.req.param("id");
-    const tools = await mcpInspector.getServerTools(id);
-    return c.json({ tools });
-  } catch {
-    return c.json({ error: "Failed to get server tools" }, 500);
-  }
-});
-app.get("/api/servers/:id/resources", async (c) => {
-  try {
-    const id = c.req.param("id");
-    const resources = await mcpInspector.getServerResources(id);
-    return c.json({ resources });
-  } catch {
-    return c.json({ error: "Failed to get server resources" }, 500);
-  }
-});
-app.delete("/api/servers/:id", async (c) => {
-  try {
-    const id = c.req.param("id");
-    await mcpInspector.disconnectServer(id);
-    return c.json({ success: true });
-  } catch {
-    return c.json({ error: "Failed to disconnect server" }, 500);
-  }
-});
-var clientDistPath = (0, import_node_path.join)(__dirname, "../../dist/client");
-if ((0, import_node_fs.existsSync)(clientDistPath)) {
-  app.get("/inspector/assets/*", async (c) => {
-    const path = c.req.path.replace("/inspector/assets/", "assets/");
-    const fullPath = (0, import_node_path.join)(clientDistPath, path);
-    if ((0, import_node_fs.existsSync)(fullPath)) {
-      const content = await import("fs").then((fs) => fs.readFileSync(fullPath));
-      if (path.endsWith(".js")) {
-        c.header("Content-Type", "application/javascript");
-      } else if (path.endsWith(".css")) {
-        c.header("Content-Type", "text/css");
-      } else if (path.endsWith(".svg")) {
-        c.header("Content-Type", "image/svg+xml");
-      }
-      return c.body(content);
-    }
-    return c.notFound();
-  });
-  app.get("/", (c) => {
-    return c.redirect("/inspector");
-  });
-  app.get("*", (c) => {
-    const indexPath = (0, import_node_path.join)(clientDistPath, "index.html");
-    if ((0, import_node_fs.existsSync)(indexPath)) {
-      const content = import("fs").then((fs) => fs.readFileSync(indexPath, "utf-8"));
-      return c.html(content);
-    }
-    return c.html(`
-      <!DOCTYPE html>
-      <html>
-        <head>
-          <title>MCP Inspector</title>
-        </head>
-        <body>
-          <h1>MCP Inspector</h1>
-          <p>Client files not found. Please run 'yarn build' to build the UI.</p>
-          <p>API is available at <a href="/api/servers">/api/servers</a></p>
-        </body>
-      </html>
-    `);
-  });
-} else {
-  console.warn(`\u26A0\uFE0F  MCP Inspector client files not found at ${clientDistPath}`);
-  console.warn(`   Run 'yarn build' in the inspector package to build the UI`);
-  app.get("*", (c) => {
-    return c.html(`
-      <!DOCTYPE html>
-      <html>
-        <head>
-          <title>MCP Inspector</title>
-        </head>
-        <body>
-          <h1>MCP Inspector</h1>
-          <p>Client files not found. Please run 'yarn build' to build the UI.</p>
-          <p>API is available at <a href="/api/servers">/api/servers</a></p>
-        </body>
-      </html>
-    `);
-  });
-}
-async function startServer() {
-  try {
-    const port = await findAvailablePort(startPort);
-    (0, import_node_server.serve)({
-      fetch: app.fetch,
-      port
-    });
-    console.log(`\u{1F680} MCP Inspector running on http://localhost:${port}`);
-    if (mcpUrl) {
-      console.log(`\u{1F4E1} Auto-connecting to: ${mcpUrl}`);
-    }
-    try {
-      const command = process.platform === "win32" ? "start" : process.platform === "darwin" ? "open" : "xdg-open";
-      await execAsync(`${command} http://localhost:${port}`);
-      console.log(`\u{1F310} Browser opened automatically`);
-    } catch (error) {
-      console.log(`\u{1F310} Please open http://localhost:${port} in your browser`);
-    }
-    return { port, fetch: app.fetch };
-  } catch (error) {
-    console.error("Failed to start server:", error);
-    process.exit(1);
-  }
-}
-startServer();