@ivotoby/openapi-mcp-server 1.13.0 → 1.14.0

package/README.md

@@ -132,6 +132,7 @@ The server can be configured through environment variables or command line argum
 - `ENDPOINT_PATH` - Endpoint path for HTTP transport (default: "/mcp")
 - `TOOLS_MODE` - Tools loading mode: "all" (load all endpoint-based tools), "dynamic" (load only meta-tools), or "explicit" (load only tools specified in includeTools) (default: "all")
 - `DISABLE_ABBREVIATION` - Disable name optimization (this could throw errors when name is > 64 chars)
+- `VERBOSE` - Enable operational logging (`true` by default; set to `false` to suppress non-essential logs)
 - `PROMPTS_PATH` - Path or URL to prompts JSON/YAML file
 - `PROMPTS_INLINE` - Provide prompts directly as JSON string
 - `RESOURCES_PATH` - Path or URL to resources JSON/YAML file
@@ -152,7 +153,8 @@ npx @ivotoby/openapi-mcp-server \
   --port 3000 \
   --host 127.0.0.1 \
   --path /mcp \
-  --disable-abbreviation true
+  --disable-abbreviation true \
+  --verbose false
 ```
 
 ## Mutual TLS (mTLS)
@@ -191,6 +193,8 @@ npx @ivotoby/openapi-mcp-server \
 - `--ca-cert` / `CA_CERT_PATH`: custom CA bundle for private/internal certificate authorities
 - `--reject-unauthorized` / `REJECT_UNAUTHORIZED`: set to `false` only when you intentionally want to allow self-signed or otherwise untrusted server certificates
 
+Set `--verbose false` or `VERBOSE=false` if you want the server to stay quiet in scripts or embedded environments.
+
 ## OpenAPI Specification Loading
 
 The MCP server supports multiple methods for loading OpenAPI specifications, providing flexibility for different deployment scenarios:

package/dist/bundle.js

@@ -14408,14 +14408,39 @@ function generateToolId(method, path2) {
   return `${method.toUpperCase()}::${sanitizedPath}`;
 }
 
+// src/utils/logger.ts
+var Logger = class {
+  constructor(verbose = true) {
+    this.verbose = verbose;
+  }
+  setVerbose(verbose) {
+    this.verbose = verbose ?? true;
+  }
+  warn(message, ...optionalParams) {
+    if (this.verbose) {
+      console.warn(message, ...optionalParams);
+    }
+  }
+  error(message, ...optionalParams) {
+    if (this.verbose) {
+      console.error(message, ...optionalParams);
+    }
+  }
+  fatal(message, ...optionalParams) {
+    console.error(message, ...optionalParams);
+  }
+};
+
 // src/openapi-loader.ts
 var OpenAPISpecLoader = class {
   /**
    * Disable name optimization
    */
   disableAbbreviation;
+  logger;
   constructor(config) {
     this.disableAbbreviation = config?.disableAbbreviation ?? false;
+    this.logger = new Logger(config?.verbose ?? true);
   }
   /**
    * Load an OpenAPI specification from various sources
@@ -14635,7 +14660,7 @@ var OpenAPISpecLoader = class {
    */
   determineParameterType(paramSchema, paramName) {
     if (Object.keys(paramSchema).length === 0 && typeof paramSchema !== "boolean") {
-      console.warn(
+      this.logger.warn(
         `Parameter '${paramName}' schema was empty after inlining (potential cycle or unresolvable ref), defaulting to string.`
       );
       return "string";
@@ -14691,19 +14716,19 @@ var OpenAPISpecLoader = class {
               if (resolvedParam && "name" in resolvedParam && "in" in resolvedParam) {
                 paramObj = resolvedParam;
               } else {
-                console.warn(
+                this.logger.warn(
                   `Could not resolve path-level parameter reference or invalid structure: ${param.$ref}`
                 );
                 continue;
               }
             } else {
-              console.warn(`Could not parse path-level parameter reference: ${param.$ref}`);
+              this.logger.warn(`Could not parse path-level parameter reference: ${param.$ref}`);
               continue;
             }
           } else if ("name" in param && "in" in param) {
             paramObj = param;
           } else {
-            console.warn(
+            this.logger.warn(
               "Skipping path-level parameter due to missing 'name' or 'in' properties and not being a valid $ref:",
               param
             );
@@ -14719,7 +14744,7 @@ var OpenAPISpecLoader = class {
         if (!["get", "post", "put", "patch", "delete", "options", "head"].includes(
           method.toLowerCase()
         )) {
-          console.warn(`Skipping non-HTTP method "${method}" for path ${path2}`);
+          this.logger.warn(`Skipping non-HTTP method "${method}" for path ${path2}`);
           continue;
         }
         const op = operation;
@@ -14757,19 +14782,19 @@ var OpenAPISpecLoader = class {
                 if (resolvedParam && "name" in resolvedParam && "in" in resolvedParam) {
                   paramObj = resolvedParam;
                 } else {
-                  console.warn(
+                  this.logger.warn(
                     `Could not resolve parameter reference or invalid structure: ${param.$ref}`
                   );
                   continue;
                 }
               } else {
-                console.warn(`Could not parse parameter reference: ${param.$ref}`);
+                this.logger.warn(`Could not parse parameter reference: ${param.$ref}`);
                 continue;
               }
             } else if ("name" in param && "in" in param) {
               paramObj = param;
             } else {
-              console.warn(
+              this.logger.warn(
                 "Skipping parameter due to missing 'name' or 'in' properties and not being a valid $ref:",
                 param
               );
@@ -14820,19 +14845,19 @@ var OpenAPISpecLoader = class {
               if (resolvedRequestBody && "content" in resolvedRequestBody) {
                 requestBodyObj = resolvedRequestBody;
               } else {
-                console.warn(
+                this.logger.warn(
                   `Could not resolve requestBody reference or invalid structure: ${op.requestBody.$ref}`
                 );
                 continue;
               }
             } else {
-              console.warn(`Could not parse requestBody reference: ${op.requestBody.$ref}`);
+              this.logger.warn(`Could not parse requestBody reference: ${op.requestBody.$ref}`);
               continue;
             }
           } else if ("content" in op.requestBody) {
             requestBodyObj = op.requestBody;
           } else {
-            console.warn("Skipping requestBody due to invalid structure:", op.requestBody);
+            this.logger.warn("Skipping requestBody due to invalid structure:", op.requestBody);
             continue;
           }
           let mediaTypeObj;
@@ -15035,12 +15060,15 @@ var ToolsManager = class {
     this.config = config;
     this.config.toolsMode = this.config.toolsMode || "all";
     this.specLoader = new OpenAPISpecLoader({
-      disableAbbreviation: this.config.disableAbbreviation
+      disableAbbreviation: this.config.disableAbbreviation,
+      verbose: this.config.verbose
     });
+    this.logger = new Logger(this.config.verbose);
   }
   tools = /* @__PURE__ */ new Map();
   specLoader;
   loadedSpec;
+  logger;
   /**
    * Get the OpenAPI spec loader instance
    */
@@ -15126,7 +15154,7 @@ var ToolsManager = class {
       }
       this.tools = filtered2;
       for (const [toolId, tool] of this.tools.entries()) {
-        console.error(`Registered tool: ${toolId} (${tool.name})`);
+        this.logger.error(`Registered tool: ${toolId} (${tool.name})`);
       }
       return;
     }
@@ -15172,7 +15200,7 @@ var ToolsManager = class {
     }
     this.tools = filtered;
     for (const [toolId, tool] of this.tools.entries()) {
-      console.error(`Registered tool: ${toolId} (${tool.name})`);
+      this.logger.error(`Registered tool: ${toolId} (${tool.name})`);
     }
   }
   /**
@@ -19771,8 +19799,10 @@ var OpenAPIServer = class {
   promptsManager;
   resourcesManager;
   config;
+  logger;
   constructor(config) {
     this.config = config;
+    this.logger = new Logger(config.verbose);
     if (config.prompts?.length) {
       this.promptsManager = new PromptsManager({ prompts: config.prompts });
     }
@@ -19856,21 +19886,21 @@ var OpenAPIServer = class {
     });
     this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const { id, name, arguments: params } = request.params;
-      console.error("Received request:", request.params);
-      console.error("Using parameters from arguments:", params);
+      this.logger.error("Received request:", request.params);
+      this.logger.error("Using parameters from arguments:", params);
       const idOrName = typeof id === "string" ? id : typeof name === "string" ? name : "";
       if (!idOrName) {
         throw new Error("Tool ID or name is required");
       }
       const toolInfo = this.toolsManager.findTool(idOrName);
       if (!toolInfo) {
-        console.error(
+        this.logger.error(
           `Available tools: ${Array.from(this.toolsManager.getAllTools()).map((t) => t.name).join(", ")}`
         );
         throw new Error(`Tool not found: ${idOrName}`);
       }
       const { toolId, tool } = toolInfo;
-      console.error(`Executing tool: ${toolId} (${tool.name})`);
+      this.logger.error(`Executing tool: ${toolId} (${tool.name})`);
       try {
         const result = await this.apiClient.executeApiCall(toolId, params || {});
         return {
@@ -24918,6 +24948,9 @@ function loadConfig() {
   }).option("resources-inline", {
     type: "string",
     description: "Provide resources directly as JSON string"
+  }).option("verbose", {
+    type: "string",
+    description: "Enable verbose logging"
   }).help().parseSync();
   let transportType;
   if (argv.transport === "http" || process.env.TRANSPORT_TYPE === "http") {
@@ -24980,6 +25013,7 @@ function loadConfig() {
     argv["reject-unauthorized"] ?? process.env.REJECT_UNAUTHORIZED,
     "--reject-unauthorized/REJECT_UNAUTHORIZED"
   );
+  const verbose = parseOptionalBoolean(argv.verbose ?? process.env.VERBOSE, "--verbose/VERBOSE") ?? true;
   return {
     name: argv.name || process.env.SERVER_NAME || "mcp-openapi-server",
     version: argv["server-version"] || process.env.SERVER_VERSION || "1.0.0",
@@ -25006,7 +25040,8 @@ function loadConfig() {
     promptsPath: argv.prompts || process.env.PROMPTS_PATH,
     promptsInline: argv["prompts-inline"] || process.env.PROMPTS_INLINE,
     resourcesPath: argv.resources || process.env.RESOURCES_PATH,
-    resourcesInline: argv["resources-inline"] || process.env.RESOURCES_INLINE
+    resourcesInline: argv["resources-inline"] || process.env.RESOURCES_INLINE,
+    verbose
   };
 }
 
@@ -25019,7 +25054,6 @@ import {
 import * as http3 from "http";
 import { randomUUID } from "crypto";
 var StreamableHttpServerTransport = class {
-  // Track if using an external server
   /**
    * Initialize a new StreamableHttpServerTransport
    *
@@ -25034,11 +25068,12 @@ var StreamableHttpServerTransport = class {
    *               further handlers from running for those requests. The MCP handler should be added after
    *               custom handlers and will return early for non-MCP paths.
    */
-  constructor(port, host = "127.0.0.1", endpointPath = "/mcp", server) {
+  constructor(port, host = "127.0.0.1", endpointPath = "/mcp", server, verbose = true) {
     this.port = port;
     this.host = host;
     this.endpointPath = endpointPath;
     this.isExternalServer = !!server;
+    this.logger = new Logger(verbose);
     if (server) {
       this.server = server;
       this.server.on("request", this.handleRequest.bind(this));
@@ -25056,6 +25091,8 @@ var StreamableHttpServerTransport = class {
   // Maps request IDs to session IDs
   healthCheckPath = "/health";
   isExternalServer;
+  // Track if using an external server
+  logger;
   /**
    * Callback when message is received
    */
@@ -25078,7 +25115,7 @@ var StreamableHttpServerTransport = class {
     return new Promise((resolve6, reject) => {
       this.server.listen(this.port, this.host, () => {
         this.started = true;
-        console.error(
+        this.logger.error(
           `Streamable HTTP transport listening on http://${this.host}:${this.port}${this.endpointPath}`
         );
         resolve6();
@@ -25131,34 +25168,34 @@ var StreamableHttpServerTransport = class {
    * @param message JSON-RPC message
    */
   async send(message) {
-    console.error(`StreamableHttpServerTransport: Sending message: ${JSON.stringify(message)}`);
+    this.logger.error(`StreamableHttpServerTransport: Sending message: ${JSON.stringify(message)}`);
     let targetSessionId;
     let messageIdForThisResponse = null;
     if (isJSONRPCResponse(message) && message.id !== null) {
       messageIdForThisResponse = message.id;
       targetSessionId = this.requestSessionMap.get(messageIdForThisResponse);
-      console.error(
+      this.logger.error(
         `StreamableHttpServerTransport: Potential target session for response ID ${messageIdForThisResponse}: ${targetSessionId}`
       );
       if (targetSessionId && this.initResponseHandlers.has(targetSessionId)) {
-        console.error(
+        this.logger.error(
           `StreamableHttpServerTransport: Session ${targetSessionId} has initResponseHandlers. Invoking them for message ID ${messageIdForThisResponse}.`
         );
         const handlers = this.initResponseHandlers.get(targetSessionId);
         [...handlers].forEach((handler) => handler(message));
         if (!this.requestSessionMap.has(messageIdForThisResponse)) {
-          console.error(
+          this.logger.error(
             `StreamableHttpServerTransport: Response for ID ${messageIdForThisResponse} was handled by an initResponseHandler (e.g., synchronous POST response for initialize or tools/list).`
           );
           return;
         } else {
-          console.error(
+          this.logger.error(
             `StreamableHttpServerTransport: Response for ID ${messageIdForThisResponse} was NOT exclusively handled by an initResponseHandler or handler did not remove from requestSessionMap. Proceeding to GET stream / broadcast if applicable.`
           );
         }
       }
       if (this.requestSessionMap.has(messageIdForThisResponse)) {
-        console.error(
+        this.logger.error(
           `StreamableHttpServerTransport: Deleting request ID ${messageIdForThisResponse} from requestSessionMap as it's being processed for GET stream or broadcast.`
         );
         this.requestSessionMap.delete(messageIdForThisResponse);
@@ -25166,7 +25203,7 @@ var StreamableHttpServerTransport = class {
     }
     if (!targetSessionId) {
       const idForLog = messageIdForThisResponse !== null ? messageIdForThisResponse : isJSONRPCRequest(message) ? message.id : "N/A";
-      console.warn(
+      this.logger.warn(
         `StreamableHttpServerTransport: No specific target session for message (ID: ${idForLog}). Broadcasting to all applicable sessions.`
       );
       for (const [sid, session2] of this.sessions.entries()) {
@@ -25178,12 +25215,12 @@ var StreamableHttpServerTransport = class {
     }
     const session = this.sessions.get(targetSessionId);
     if (session && session.activeResponses.size > 0) {
-      console.error(
+      this.logger.error(
         `StreamableHttpServerTransport: Sending message (ID: ${messageIdForThisResponse}) to GET stream for session ${targetSessionId} (${session.activeResponses.size} active connections).`
       );
       this.sendMessageToSession(targetSessionId, session, message);
     } else if (targetSessionId) {
-      console.error(
+      this.logger.error(
         `StreamableHttpServerTransport: No active GET connections for session ${targetSessionId} to send message (ID: ${messageIdForThisResponse}). Message might not be delivered if not handled by POST.`
       );
     }
@@ -25662,20 +25699,22 @@ async function loadResources(pathOrUrl, inline) {
 
 // src/index.ts
 async function main() {
+  const logger = new Logger(true);
   try {
     const config = loadConfig();
+    logger.setVerbose(config.verbose);
     if (config.promptsPath || config.promptsInline) {
       const prompts = await loadPrompts(config.promptsPath, config.promptsInline);
       if (prompts) {
         config.prompts = prompts;
-        console.error(`Loaded ${prompts.length} prompt(s)`);
+        logger.error(`Loaded ${prompts.length} prompt(s)`);
       }
     }
     if (config.resourcesPath || config.resourcesInline) {
       const resources = await loadResources(config.resourcesPath, config.resourcesInline);
       if (resources) {
         config.resources = resources;
-        console.error(`Loaded ${resources.length} resource(s)`);
+        logger.error(`Loaded ${resources.length} resource(s)`);
       }
     }
     const server = new OpenAPIServer(config);
@@ -25684,24 +25723,27 @@ async function main() {
       transport = new StreamableHttpServerTransport(
         config.httpPort,
         config.httpHost,
-        config.endpointPath
+        config.endpointPath,
+        void 0,
+        config.verbose
       );
       await server.start(transport);
-      console.error(
+      logger.error(
         `OpenAPI MCP Server running on http://${config.httpHost}:${config.httpPort}${config.endpointPath}`
       );
     } else {
       transport = new StdioServerTransport();
       await server.start(transport);
-      console.error("OpenAPI MCP Server running on stdio");
+      logger.error("OpenAPI MCP Server running on stdio");
     }
   } catch (error) {
-    console.error("Failed to start server:", error);
+    logger.fatal("Failed to start server:", error);
     process.exit(1);
   }
 }
 export {
   ApiClient,
+  Logger,
   OpenAPIServer,
   OpenAPISpecLoader,
   PromptsManager,

package/dist/cli.js

@@ -14408,14 +14408,39 @@ function generateToolId(method, path2) {
   return `${method.toUpperCase()}::${sanitizedPath}`;
 }
 
+// src/utils/logger.ts
+var Logger = class {
+  constructor(verbose = true) {
+    this.verbose = verbose;
+  }
+  setVerbose(verbose) {
+    this.verbose = verbose ?? true;
+  }
+  warn(message, ...optionalParams) {
+    if (this.verbose) {
+      console.warn(message, ...optionalParams);
+    }
+  }
+  error(message, ...optionalParams) {
+    if (this.verbose) {
+      console.error(message, ...optionalParams);
+    }
+  }
+  fatal(message, ...optionalParams) {
+    console.error(message, ...optionalParams);
+  }
+};
+
 // src/openapi-loader.ts
 var OpenAPISpecLoader = class {
   /**
    * Disable name optimization
    */
   disableAbbreviation;
+  logger;
   constructor(config) {
     this.disableAbbreviation = config?.disableAbbreviation ?? false;
+    this.logger = new Logger(config?.verbose ?? true);
   }
   /**
    * Load an OpenAPI specification from various sources
@@ -14635,7 +14660,7 @@ var OpenAPISpecLoader = class {
    */
   determineParameterType(paramSchema, paramName) {
     if (Object.keys(paramSchema).length === 0 && typeof paramSchema !== "boolean") {
-      console.warn(
+      this.logger.warn(
         `Parameter '${paramName}' schema was empty after inlining (potential cycle or unresolvable ref), defaulting to string.`
       );
       return "string";
@@ -14691,19 +14716,19 @@ var OpenAPISpecLoader = class {
               if (resolvedParam && "name" in resolvedParam && "in" in resolvedParam) {
                 paramObj = resolvedParam;
               } else {
-                console.warn(
+                this.logger.warn(
                   `Could not resolve path-level parameter reference or invalid structure: ${param.$ref}`
                 );
                 continue;
               }
             } else {
-              console.warn(`Could not parse path-level parameter reference: ${param.$ref}`);
+              this.logger.warn(`Could not parse path-level parameter reference: ${param.$ref}`);
               continue;
             }
           } else if ("name" in param && "in" in param) {
             paramObj = param;
           } else {
-            console.warn(
+            this.logger.warn(
               "Skipping path-level parameter due to missing 'name' or 'in' properties and not being a valid $ref:",
               param
             );
@@ -14719,7 +14744,7 @@ var OpenAPISpecLoader = class {
         if (!["get", "post", "put", "patch", "delete", "options", "head"].includes(
           method.toLowerCase()
         )) {
-          console.warn(`Skipping non-HTTP method "${method}" for path ${path2}`);
+          this.logger.warn(`Skipping non-HTTP method "${method}" for path ${path2}`);
           continue;
         }
         const op = operation;
@@ -14757,19 +14782,19 @@ var OpenAPISpecLoader = class {
                 if (resolvedParam && "name" in resolvedParam && "in" in resolvedParam) {
                   paramObj = resolvedParam;
                 } else {
-                  console.warn(
+                  this.logger.warn(
                     `Could not resolve parameter reference or invalid structure: ${param.$ref}`
                   );
                   continue;
                 }
               } else {
-                console.warn(`Could not parse parameter reference: ${param.$ref}`);
+                this.logger.warn(`Could not parse parameter reference: ${param.$ref}`);
                 continue;
               }
             } else if ("name" in param && "in" in param) {
               paramObj = param;
             } else {
-              console.warn(
+              this.logger.warn(
                 "Skipping parameter due to missing 'name' or 'in' properties and not being a valid $ref:",
                 param
               );
@@ -14820,19 +14845,19 @@ var OpenAPISpecLoader = class {
               if (resolvedRequestBody && "content" in resolvedRequestBody) {
                 requestBodyObj = resolvedRequestBody;
               } else {
-                console.warn(
+                this.logger.warn(
                   `Could not resolve requestBody reference or invalid structure: ${op.requestBody.$ref}`
                 );
                 continue;
               }
             } else {
-              console.warn(`Could not parse requestBody reference: ${op.requestBody.$ref}`);
+              this.logger.warn(`Could not parse requestBody reference: ${op.requestBody.$ref}`);
               continue;
             }
           } else if ("content" in op.requestBody) {
             requestBodyObj = op.requestBody;
           } else {
-            console.warn("Skipping requestBody due to invalid structure:", op.requestBody);
+            this.logger.warn("Skipping requestBody due to invalid structure:", op.requestBody);
             continue;
           }
           let mediaTypeObj;
@@ -15035,12 +15060,15 @@ var ToolsManager = class {
     this.config = config;
     this.config.toolsMode = this.config.toolsMode || "all";
     this.specLoader = new OpenAPISpecLoader({
-      disableAbbreviation: this.config.disableAbbreviation
+      disableAbbreviation: this.config.disableAbbreviation,
+      verbose: this.config.verbose
     });
+    this.logger = new Logger(this.config.verbose);
   }
   tools = /* @__PURE__ */ new Map();
   specLoader;
   loadedSpec;
+  logger;
   /**
    * Get the OpenAPI spec loader instance
    */
@@ -15126,7 +15154,7 @@ var ToolsManager = class {
       }
       this.tools = filtered2;
       for (const [toolId, tool] of this.tools.entries()) {
-        console.error(`Registered tool: ${toolId} (${tool.name})`);
+        this.logger.error(`Registered tool: ${toolId} (${tool.name})`);
       }
       return;
     }
@@ -15172,7 +15200,7 @@ var ToolsManager = class {
     }
     this.tools = filtered;
     for (const [toolId, tool] of this.tools.entries()) {
-      console.error(`Registered tool: ${toolId} (${tool.name})`);
+      this.logger.error(`Registered tool: ${toolId} (${tool.name})`);
     }
   }
   /**
@@ -19771,8 +19799,10 @@ var OpenAPIServer = class {
   promptsManager;
   resourcesManager;
   config;
+  logger;
   constructor(config) {
     this.config = config;
+    this.logger = new Logger(config.verbose);
     if (config.prompts?.length) {
       this.promptsManager = new PromptsManager({ prompts: config.prompts });
     }
@@ -19856,21 +19886,21 @@ var OpenAPIServer = class {
     });
     this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const { id, name, arguments: params } = request.params;
-      console.error("Received request:", request.params);
-      console.error("Using parameters from arguments:", params);
+      this.logger.error("Received request:", request.params);
+      this.logger.error("Using parameters from arguments:", params);
       const idOrName = typeof id === "string" ? id : typeof name === "string" ? name : "";
       if (!idOrName) {
         throw new Error("Tool ID or name is required");
       }
       const toolInfo = this.toolsManager.findTool(idOrName);
       if (!toolInfo) {
-        console.error(
+        this.logger.error(
           `Available tools: ${Array.from(this.toolsManager.getAllTools()).map((t) => t.name).join(", ")}`
         );
         throw new Error(`Tool not found: ${idOrName}`);
       }
       const { toolId, tool } = toolInfo;
-      console.error(`Executing tool: ${toolId} (${tool.name})`);
+      this.logger.error(`Executing tool: ${toolId} (${tool.name})`);
       try {
         const result = await this.apiClient.executeApiCall(toolId, params || {});
         return {
@@ -24918,6 +24948,9 @@ function loadConfig() {
   }).option("resources-inline", {
     type: "string",
     description: "Provide resources directly as JSON string"
+  }).option("verbose", {
+    type: "string",
+    description: "Enable verbose logging"
   }).help().parseSync();
   let transportType;
   if (argv.transport === "http" || process.env.TRANSPORT_TYPE === "http") {
@@ -24980,6 +25013,7 @@ function loadConfig() {
     argv["reject-unauthorized"] ?? process.env.REJECT_UNAUTHORIZED,
     "--reject-unauthorized/REJECT_UNAUTHORIZED"
   );
+  const verbose = parseOptionalBoolean(argv.verbose ?? process.env.VERBOSE, "--verbose/VERBOSE") ?? true;
   return {
     name: argv.name || process.env.SERVER_NAME || "mcp-openapi-server",
     version: argv["server-version"] || process.env.SERVER_VERSION || "1.0.0",
@@ -25006,7 +25040,8 @@ function loadConfig() {
     promptsPath: argv.prompts || process.env.PROMPTS_PATH,
     promptsInline: argv["prompts-inline"] || process.env.PROMPTS_INLINE,
     resourcesPath: argv.resources || process.env.RESOURCES_PATH,
-    resourcesInline: argv["resources-inline"] || process.env.RESOURCES_INLINE
+    resourcesInline: argv["resources-inline"] || process.env.RESOURCES_INLINE,
+    verbose
   };
 }
 
@@ -25019,7 +25054,6 @@ import {
 import * as http3 from "http";
 import { randomUUID } from "crypto";
 var StreamableHttpServerTransport = class {
-  // Track if using an external server
   /**
    * Initialize a new StreamableHttpServerTransport
    *
@@ -25034,11 +25068,12 @@ var StreamableHttpServerTransport = class {
    *               further handlers from running for those requests. The MCP handler should be added after
    *               custom handlers and will return early for non-MCP paths.
    */
-  constructor(port, host = "127.0.0.1", endpointPath = "/mcp", server) {
+  constructor(port, host = "127.0.0.1", endpointPath = "/mcp", server, verbose = true) {
     this.port = port;
     this.host = host;
     this.endpointPath = endpointPath;
     this.isExternalServer = !!server;
+    this.logger = new Logger(verbose);
     if (server) {
       this.server = server;
       this.server.on("request", this.handleRequest.bind(this));
@@ -25056,6 +25091,8 @@ var StreamableHttpServerTransport = class {
   // Maps request IDs to session IDs
   healthCheckPath = "/health";
   isExternalServer;
+  // Track if using an external server
+  logger;
   /**
    * Callback when message is received
    */
@@ -25078,7 +25115,7 @@ var StreamableHttpServerTransport = class {
     return new Promise((resolve6, reject) => {
       this.server.listen(this.port, this.host, () => {
         this.started = true;
-        console.error(
+        this.logger.error(
           `Streamable HTTP transport listening on http://${this.host}:${this.port}${this.endpointPath}`
         );
         resolve6();
@@ -25131,34 +25168,34 @@ var StreamableHttpServerTransport = class {
    * @param message JSON-RPC message
    */
   async send(message) {
-    console.error(`StreamableHttpServerTransport: Sending message: ${JSON.stringify(message)}`);
+    this.logger.error(`StreamableHttpServerTransport: Sending message: ${JSON.stringify(message)}`);
     let targetSessionId;
     let messageIdForThisResponse = null;
     if (isJSONRPCResponse(message) && message.id !== null) {
       messageIdForThisResponse = message.id;
       targetSessionId = this.requestSessionMap.get(messageIdForThisResponse);
-      console.error(
+      this.logger.error(
         `StreamableHttpServerTransport: Potential target session for response ID ${messageIdForThisResponse}: ${targetSessionId}`
       );
       if (targetSessionId && this.initResponseHandlers.has(targetSessionId)) {
-        console.error(
+        this.logger.error(
           `StreamableHttpServerTransport: Session ${targetSessionId} has initResponseHandlers. Invoking them for message ID ${messageIdForThisResponse}.`
         );
         const handlers = this.initResponseHandlers.get(targetSessionId);
         [...handlers].forEach((handler) => handler(message));
         if (!this.requestSessionMap.has(messageIdForThisResponse)) {
-          console.error(
+          this.logger.error(
             `StreamableHttpServerTransport: Response for ID ${messageIdForThisResponse} was handled by an initResponseHandler (e.g., synchronous POST response for initialize or tools/list).`
           );
           return;
         } else {
-          console.error(
+          this.logger.error(
             `StreamableHttpServerTransport: Response for ID ${messageIdForThisResponse} was NOT exclusively handled by an initResponseHandler or handler did not remove from requestSessionMap. Proceeding to GET stream / broadcast if applicable.`
           );
         }
       }
       if (this.requestSessionMap.has(messageIdForThisResponse)) {
-        console.error(
+        this.logger.error(
           `StreamableHttpServerTransport: Deleting request ID ${messageIdForThisResponse} from requestSessionMap as it's being processed for GET stream or broadcast.`
         );
         this.requestSessionMap.delete(messageIdForThisResponse);
@@ -25166,7 +25203,7 @@ var StreamableHttpServerTransport = class {
     }
     if (!targetSessionId) {
       const idForLog = messageIdForThisResponse !== null ? messageIdForThisResponse : isJSONRPCRequest(message) ? message.id : "N/A";
-      console.warn(
+      this.logger.warn(
         `StreamableHttpServerTransport: No specific target session for message (ID: ${idForLog}). Broadcasting to all applicable sessions.`
       );
       for (const [sid, session2] of this.sessions.entries()) {
@@ -25178,12 +25215,12 @@ var StreamableHttpServerTransport = class {
     }
     const session = this.sessions.get(targetSessionId);
     if (session && session.activeResponses.size > 0) {
-      console.error(
+      this.logger.error(
         `StreamableHttpServerTransport: Sending message (ID: ${messageIdForThisResponse}) to GET stream for session ${targetSessionId} (${session.activeResponses.size} active connections).`
       );
       this.sendMessageToSession(targetSessionId, session, message);
     } else if (targetSessionId) {
-      console.error(
+      this.logger.error(
         `StreamableHttpServerTransport: No active GET connections for session ${targetSessionId} to send message (ID: ${messageIdForThisResponse}). Message might not be delivered if not handled by POST.`
       );
     }
@@ -25662,20 +25699,22 @@ async function loadResources(pathOrUrl, inline) {
 
 // src/index.ts
 async function main() {
+  const logger = new Logger(true);
   try {
     const config = loadConfig();
+    logger.setVerbose(config.verbose);
     if (config.promptsPath || config.promptsInline) {
       const prompts = await loadPrompts(config.promptsPath, config.promptsInline);
       if (prompts) {
         config.prompts = prompts;
-        console.error(`Loaded ${prompts.length} prompt(s)`);
+        logger.error(`Loaded ${prompts.length} prompt(s)`);
       }
     }
     if (config.resourcesPath || config.resourcesInline) {
       const resources = await loadResources(config.resourcesPath, config.resourcesInline);
       if (resources) {
         config.resources = resources;
-        console.error(`Loaded ${resources.length} resource(s)`);
+        logger.error(`Loaded ${resources.length} resource(s)`);
       }
     }
     const server = new OpenAPIServer(config);
@@ -25684,19 +25723,21 @@ async function main() {
       transport = new StreamableHttpServerTransport(
         config.httpPort,
         config.httpHost,
-        config.endpointPath
+        config.endpointPath,
+        void 0,
+        config.verbose
       );
       await server.start(transport);
-      console.error(
+      logger.error(
         `OpenAPI MCP Server running on http://${config.httpHost}:${config.httpPort}${config.endpointPath}`
       );
     } else {
       transport = new StdioServerTransport();
       await server.start(transport);
-      console.error("OpenAPI MCP Server running on stdio");
+      logger.error("OpenAPI MCP Server running on stdio");
     }
   } catch (error) {
-    console.error("Failed to start server:", error);
+    logger.fatal("Failed to start server:", error);
     process.exit(1);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ivotoby/openapi-mcp-server",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "An MCP server that exposes OpenAPI endpoints as resources",
   "license": "MIT",
   "type": "module",