@ivotoby/openapi-mcp-server 1.9.3 → 1.10.1

package/README.md

@@ -297,6 +297,48 @@ The HTTP transport allows the MCP server to be accessed over HTTP, enabling web
 
 **When to use**: When you need to expose the MCP server to web clients or systems that communicate over HTTP rather than stdio.
 
+### Health Check Endpoint
+
+When using HTTP transport, a health check endpoint is available at `/health` for monitoring and service discovery:
+
+```bash
+# Check server health
+curl http://localhost:3000/health
+
+# Response:
+# {
+#   "status": "healthy",
+#   "activeSessions": 2,
+#   "uptime": 3600
+# }
+```
+
+**Health Response Fields:**
+- `status`: Always returns "healthy" when server is running
+- `activeSessions`: Number of active MCP sessions
+- `uptime`: Server uptime in seconds
+
+**Key Features:**
+- No authentication required
+- Works with any HTTP method (GET, POST, etc.)
+- Ideal for load balancers, Kubernetes probes, and monitoring systems
+
+**Integration Examples:**
+
+```yaml
+# Kubernetes liveness probe
+livenessProbe:
+  httpGet:
+    path: /health
+    port: 3000
+  initialDelaySeconds: 3
+  periodSeconds: 10
+
+# Docker healthcheck
+HEALTHCHECK --interval=30s --timeout=3s \
+  CMD curl -f http://localhost:3000/health || exit 1
+```
+
 ## Security Considerations
 
 - The HTTP transport validates Origin headers to prevent DNS rebinding attacks

package/dist/bundle.js

@@ -18606,6 +18606,7 @@ var ApiClient = class {
         return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       };
       const headerParams = {};
+      const queryParams = {};
       if (toolDef?.inputSchema?.properties) {
         for (const [key, value] of Object.entries(paramsCopy)) {
           const paramDef = toolDef.inputSchema.properties[key];
@@ -18626,6 +18627,9 @@ var ApiClient = class {
               resolvedPath = resolvedPath.replace(`/${key}`, `/${encodeURIComponent(value)}`);
             }
             delete paramsCopy[key];
+          } else if (paramLocation === "query") {
+            queryParams[key] = value;
+            delete paramsCopy[key];
           } else if (paramLocation === "header") {
             headerParams[key] = String(value);
             delete paramsCopy[key];
@@ -18657,10 +18661,20 @@ var ApiClient = class {
         url: resolvedPath,
         headers: { ...authHeaders, ...headerParams }
       };
+      if (Object.keys(queryParams).length > 0) {
+        config.params = this.processQueryParams(queryParams);
+      }
       if (isGetLikeMethod(method)) {
-        config.params = this.processQueryParams(paramsCopy);
+        if (Object.keys(paramsCopy).length > 0) {
+          config.params = {
+            ...config.params,
+            ...this.processQueryParams(paramsCopy)
+          };
+        }
       } else {
-        config.data = paramsCopy;
+        if (Object.keys(paramsCopy).length > 0) {
+          config.data = paramsCopy;
+        }
       }
       const response = await this.axiosInstance(config);
       return response.data;
@@ -24000,7 +24014,6 @@ import {
 import * as http2 from "http";
 import { randomUUID } from "crypto";
 var StreamableHttpServerTransport = class {
-  // Maps request IDs to session IDs
   /**
    * Initialize a new StreamableHttpServerTransport
    *
@@ -24017,9 +24030,12 @@ var StreamableHttpServerTransport = class {
   server;
   sessions = /* @__PURE__ */ new Map();
   started = false;
+  startTime = Date.now();
   maxBodySize = 4 * 1024 * 1024;
   // 4MB max request size
   requestSessionMap = /* @__PURE__ */ new Map();
+  // Maps request IDs to session IDs
+  healthCheckPath = "/health";
   /**
    * Callback when message is received
    */
@@ -24163,10 +24179,28 @@ var StreamableHttpServerTransport = class {
       }
     }
   }
+  /**
+   * Handle health check request
+   */
+  handleHealthCheck(_req, res) {
+    const uptime = Math.floor((Date.now() - this.startTime) / 1e3);
+    const healthResponse = {
+      status: "healthy",
+      activeSessions: this.sessions.size,
+      uptime
+    };
+    res.setHeader("Content-Type", "application/json");
+    res.writeHead(200);
+    res.end(JSON.stringify(healthResponse));
+  }
   /**
    * Handle HTTP request
    */
   handleRequest(req, res) {
+    if (req.url === this.healthCheckPath) {
+      this.handleHealthCheck(req, res);
+      return;
+    }
     if (req.url !== this.endpointPath) {
       res.writeHead(404);
       res.end();

package/dist/cli.js

@@ -18606,6 +18606,7 @@ var ApiClient = class {
         return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       };
       const headerParams = {};
+      const queryParams = {};
       if (toolDef?.inputSchema?.properties) {
         for (const [key, value] of Object.entries(paramsCopy)) {
           const paramDef = toolDef.inputSchema.properties[key];
@@ -18626,6 +18627,9 @@ var ApiClient = class {
               resolvedPath = resolvedPath.replace(`/${key}`, `/${encodeURIComponent(value)}`);
             }
             delete paramsCopy[key];
+          } else if (paramLocation === "query") {
+            queryParams[key] = value;
+            delete paramsCopy[key];
           } else if (paramLocation === "header") {
             headerParams[key] = String(value);
             delete paramsCopy[key];
@@ -18657,10 +18661,20 @@ var ApiClient = class {
         url: resolvedPath,
         headers: { ...authHeaders, ...headerParams }
       };
+      if (Object.keys(queryParams).length > 0) {
+        config.params = this.processQueryParams(queryParams);
+      }
       if (isGetLikeMethod(method)) {
-        config.params = this.processQueryParams(paramsCopy);
+        if (Object.keys(paramsCopy).length > 0) {
+          config.params = {
+            ...config.params,
+            ...this.processQueryParams(paramsCopy)
+          };
+        }
       } else {
-        config.data = paramsCopy;
+        if (Object.keys(paramsCopy).length > 0) {
+          config.data = paramsCopy;
+        }
       }
       const response = await this.axiosInstance(config);
       return response.data;
@@ -24000,7 +24014,6 @@ import {
 import * as http2 from "http";
 import { randomUUID } from "crypto";
 var StreamableHttpServerTransport = class {
-  // Maps request IDs to session IDs
   /**
    * Initialize a new StreamableHttpServerTransport
    *
@@ -24017,9 +24030,12 @@ var StreamableHttpServerTransport = class {
   server;
   sessions = /* @__PURE__ */ new Map();
   started = false;
+  startTime = Date.now();
   maxBodySize = 4 * 1024 * 1024;
   // 4MB max request size
   requestSessionMap = /* @__PURE__ */ new Map();
+  // Maps request IDs to session IDs
+  healthCheckPath = "/health";
   /**
    * Callback when message is received
    */
@@ -24163,10 +24179,28 @@ var StreamableHttpServerTransport = class {
       }
     }
   }
+  /**
+   * Handle health check request
+   */
+  handleHealthCheck(_req, res) {
+    const uptime = Math.floor((Date.now() - this.startTime) / 1e3);
+    const healthResponse = {
+      status: "healthy",
+      activeSessions: this.sessions.size,
+      uptime
+    };
+    res.setHeader("Content-Type", "application/json");
+    res.writeHead(200);
+    res.end(JSON.stringify(healthResponse));
+  }
   /**
    * Handle HTTP request
    */
   handleRequest(req, res) {
+    if (req.url === this.healthCheckPath) {
+      this.handleHealthCheck(req, res);
+      return;
+    }
     if (req.url !== this.endpointPath) {
       res.writeHead(404);
       res.end();

package/package.json

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