@robinmordasiewicz/f5xc-api-mcp 1.0.84-2601020629 → 1.0.91-2601030015

package/CHANGELOG.md

@@ -23,7 +23,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - API token authentication support
 - P12 certificate (mTLS) authentication support
 - Automatic URL normalization for various F5XC URL formats
-- f5xcctl CLI command equivalents in every response
+- xcsh CLI command equivalents in every response
 - Terraform HCL examples in every response
 - MCP Resources for F5XC configuration objects via URI scheme
 - Workflow prompts for common operations:

package/README.md

@@ -10,10 +10,11 @@ other MCP-compatible tools.
 ## Features
 
 - **1500+ API Tools** - Complete coverage of F5XC API operations across 23 enriched domains
+- **Dual Transport** - STDIO for Claude/VS Code, HTTP/SSE for vLLM and web clients
 - **Domain-Based Documentation** - Tools organized by domains with intelligent 2-level and
   3-level hierarchical navigation
 - **Dual-Mode Operation** - Works without authentication (documentation mode) AND with authentication (execution mode)
-- **f5xcctl Integration** - Every response includes equivalent CLI commands
+- **xcsh Integration** - Every response includes equivalent CLI commands
 - **Terraform Examples** - Every response includes Terraform HCL examples
 - **Multiple Auth Methods** - API token and P12 certificate (mTLS) support
 - **URL Normalization** - Automatically handles various F5XC URL formats
@@ -40,6 +41,74 @@ f5xc-api-mcp
 docker run -i --rm ghcr.io/robinmordasiewicz/f5xc-api-mcp
 ```
 
+## Transport Modes
+
+The server supports two transport modes for different integration scenarios:
+
+### STDIO Mode (Default)
+
+Standard input/output transport for Claude Desktop, Claude CLI, and VS Code extensions.
+
+```bash
+f5xc-api-mcp
+```
+
+### HTTP/SSE Mode
+
+HTTP transport with Server-Sent Events for vLLM servers, web-based clients, and private LLM utilities.
+
+```bash
+# Start HTTP server on default port 3000
+f5xc-api-mcp --http
+
+# Custom port
+f5xc-api-mcp --http --port 8080
+
+# Bind to localhost only
+f5xc-api-mcp --http --host 127.0.0.1 --port 3000
+```
+
+#### HTTP Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/mcp` | POST | JSON-RPC request endpoint |
+| `/mcp` | GET | SSE streaming endpoint (requires session) |
+| `/mcp` | DELETE | Session termination |
+| `/health` | GET | Health check endpoint |
+
+#### Docker with HTTP Mode
+
+```bash
+docker run -p 3000:3000 ghcr.io/robinmordasiewicz/f5xc-api-mcp --http --port 3000
+```
+
+Or with docker-compose:
+
+```yaml
+services:
+  f5xc-mcp:
+    image: ghcr.io/robinmordasiewicz/f5xc-api-mcp
+    command: ["--http", "--port", "3000"]
+    ports:
+      - "3000:3000"
+    environment:
+      - F5XC_API_URL=https://tenant.console.ves.volterra.io
+      - F5XC_API_TOKEN=${F5XC_API_TOKEN}
+```
+
+#### Testing HTTP Mode
+
+```bash
+# Health check
+curl http://localhost:3000/health
+
+# Initialize session and send JSON-RPC request
+curl -X POST http://localhost:3000/mcp \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
+```
+
 ## Configuration
 
 ### Claude Desktop
@@ -211,11 +280,11 @@ When no credentials are provided, the server provides:
 - OpenAPI specification documentation
 - API operation explanations
 - Parameter descriptions and validation
-- f5xcctl command equivalents
+- xcsh command equivalents
 - Terraform HCL examples
 - JSON request templates
 
-This mode is ideal for users who authenticate via f5xcctl or Terraform.
+This mode is ideal for users who authenticate via xcsh or Terraform.
 
 ### Execution Mode (With Authentication)
 
@@ -377,7 +446,7 @@ wildcards only match a single subdomain level, not two levels (`tenant.staging`)
 
 **Error Example:**
 
-```
+```text
 Hostname/IP does not match certificate's altnames:
 Host: tenant.staging.console.ves.volterra.io
 Cert covers: DNS:*.console.ves.volterra.io, DNS:console.ves.volterra.io

package/dist/http-server.d.ts

@@ -0,0 +1,58 @@
+/**
+ * HTTP/SSE Transport Server for F5XC API MCP
+ *
+ * Provides HTTP-based transport for MCP communication, enabling
+ * integration with vLLM servers and other HTTP-based AI clients.
+ *
+ * Endpoints:
+ * - POST /mcp - JSON-RPC request endpoint
+ * - GET /mcp - SSE streaming endpoint
+ * - DELETE /mcp - Session termination
+ */
+import type { Server } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * HTTP server configuration options
+ */
+export interface HttpServerOptions {
+    /** Port to listen on (default: 3000) */
+    port?: number;
+    /** Host/IP to bind to (default: 0.0.0.0) */
+    host?: string;
+    /** Enable session management (default: true) */
+    enableSessions?: boolean;
+}
+/**
+ * HTTP server result containing server and transport instances
+ */
+export interface HttpServerResult {
+    /** The HTTP server instance */
+    server: Server;
+    /** The MCP transport instance */
+    transport: StreamableHTTPServerTransport;
+    /** The bound address */
+    address: string;
+}
+/**
+ * Setup HTTP server with MCP transport
+ *
+ * Creates an Express server with proper MCP endpoints for:
+ * - POST /mcp: Handle JSON-RPC requests
+ * - GET /mcp: Establish SSE stream for server-to-client messages
+ * - DELETE /mcp: Terminate session
+ *
+ * @param mcpServer - The MCP server instance to connect
+ * @param options - Server configuration options
+ * @returns Promise resolving to server and transport instances
+ */
+export declare function setupHttpServer(mcpServer: McpServer, options?: HttpServerOptions): Promise<HttpServerResult>;
+/**
+ * Cleanup all active sessions
+ */
+export declare function cleanupSessions(): Promise<void>;
+/**
+ * Get current session count
+ */
+export declare function getSessionCount(): number;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,SAAS,EAAE,6BAA6B,CAAC;IACzC,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AA4DD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA0I3B;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/http-server.js

@@ -0,0 +1,227 @@
+/**
+ * HTTP/SSE Transport Server for F5XC API MCP
+ *
+ * Provides HTTP-based transport for MCP communication, enabling
+ * integration with vLLM servers and other HTTP-based AI clients.
+ *
+ * Endpoints:
+ * - POST /mcp - JSON-RPC request endpoint
+ * - GET /mcp - SSE streaming endpoint
+ * - DELETE /mcp - Session termination
+ */
+import express from "express";
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { logger } from "./utils/logging.js";
+/**
+ * Session store for managing active MCP sessions
+ */
+const sessions = new Map();
+/**
+ * Create and configure the Express app with MCP endpoints
+ */
+function createMcpApp(host) {
+    const app = express();
+    // JSON body parsing with size limit
+    app.use(express.json({ limit: "10mb" }));
+    // DNS rebinding protection for localhost
+    if (host === "127.0.0.1" || host === "localhost") {
+        app.use((req, res, next) => {
+            const hostHeader = req.headers.host;
+            if (hostHeader) {
+                const hostname = hostHeader.split(":")[0];
+                if (hostname !== "127.0.0.1" && hostname !== "localhost") {
+                    res.status(403).json({
+                        jsonrpc: "2.0",
+                        error: {
+                            code: -32600,
+                            message: "Forbidden: DNS rebinding protection",
+                        },
+                        id: null,
+                    });
+                    return;
+                }
+            }
+            next();
+        });
+    }
+    // CORS headers for cross-origin requests
+    app.use((_req, res, next) => {
+        res.header("Access-Control-Allow-Origin", "*");
+        res.header("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+        res.header("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+        res.header("Access-Control-Expose-Headers", "mcp-session-id");
+        next();
+    });
+    // Handle preflight requests
+    app.options("/mcp", (_req, res) => {
+        res.sendStatus(204);
+    });
+    // Health check endpoint
+    app.get("/health", (_req, res) => {
+        res.json({ status: "ok", transport: "http", sessions: sessions.size });
+    });
+    return app;
+}
+/**
+ * Setup HTTP server with MCP transport
+ *
+ * Creates an Express server with proper MCP endpoints for:
+ * - POST /mcp: Handle JSON-RPC requests
+ * - GET /mcp: Establish SSE stream for server-to-client messages
+ * - DELETE /mcp: Terminate session
+ *
+ * @param mcpServer - The MCP server instance to connect
+ * @param options - Server configuration options
+ * @returns Promise resolving to server and transport instances
+ */
+export async function setupHttpServer(mcpServer, options = {}) {
+    const { port = 3000, host = "0.0.0.0", enableSessions = true } = options;
+    const app = createMcpApp(host);
+    // Handle POST /mcp - JSON-RPC requests
+    app.post("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        let transport;
+        if (enableSessions && sessionId && sessions.has(sessionId)) {
+            // Reuse existing session
+            transport = sessions.get(sessionId);
+        }
+        else {
+            // Create new transport for this request/session
+            transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: enableSessions ? () => randomUUID() : undefined,
+            });
+            // Connect the transport to the MCP server
+            await mcpServer.connect(transport);
+            // Store session if enabled
+            if (enableSessions && transport.sessionId) {
+                sessions.set(transport.sessionId, transport);
+                logger.debug("Created new MCP session", { sessionId: transport.sessionId });
+            }
+        }
+        try {
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            logger.error("Error handling POST /mcp", {
+                error: error instanceof Error ? error.message : String(error),
+                sessionId,
+            });
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32603,
+                        message: "Internal server error",
+                    },
+                    id: null,
+                });
+            }
+        }
+    });
+    // Handle GET /mcp - SSE stream for server-to-client messages
+    app.get("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (!enableSessions || !sessionId || !sessions.has(sessionId)) {
+            res.status(400).json({
+                jsonrpc: "2.0",
+                error: {
+                    code: -32600,
+                    message: "Invalid or missing session ID. Send POST first to initialize.",
+                },
+                id: null,
+            });
+            return;
+        }
+        const transport = sessions.get(sessionId);
+        try {
+            await transport.handleRequest(req, res);
+        }
+        catch (error) {
+            logger.error("Error handling GET /mcp (SSE)", {
+                error: error instanceof Error ? error.message : String(error),
+                sessionId,
+            });
+        }
+    });
+    // Handle DELETE /mcp - Session termination
+    app.delete("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && sessions.has(sessionId)) {
+            const transport = sessions.get(sessionId);
+            try {
+                await transport.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            sessions.delete(sessionId);
+            logger.debug("Terminated MCP session", { sessionId });
+            res.status(200).json({ success: true, message: "Session terminated" });
+        }
+        else {
+            res.status(404).json({
+                jsonrpc: "2.0",
+                error: {
+                    code: -32600,
+                    message: "Session not found",
+                },
+                id: null,
+            });
+        }
+    });
+    // Start the server
+    return new Promise((resolve, reject) => {
+        try {
+            const server = app.listen(port, host, () => {
+                const address = `http://${host}:${port}`;
+                logger.info("F5XC API MCP HTTP Server started", {
+                    url: `${address}/mcp`,
+                    transport: "http/sse",
+                    sessions: enableSessions ? "enabled" : "disabled",
+                });
+                // Create a placeholder transport for the result
+                // Actual transports are created per-session
+                const placeholderTransport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: enableSessions ? () => randomUUID() : undefined,
+                });
+                resolve({
+                    server,
+                    transport: placeholderTransport,
+                    address,
+                });
+            });
+            server.on("error", (error) => {
+                logger.error("HTTP server error", {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                reject(error);
+            });
+        }
+        catch (error) {
+            reject(error);
+        }
+    });
+}
+/**
+ * Cleanup all active sessions
+ */
+export async function cleanupSessions() {
+    for (const [sessionId, transport] of sessions) {
+        try {
+            await transport.close();
+        }
+        catch {
+            // Ignore close errors
+        }
+        sessions.delete(sessionId);
+        logger.debug("Cleaned up session", { sessionId });
+    }
+}
+/**
+ * Get current session count
+ */
+export function getSessionCount() {
+    return sessions.size;
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -45,9 +45,14 @@ async function main() {
 
 Usage: f5xc-api-mcp [options]
 
-Options:
-  -v, --version    Show version number
-  -h, --help       Show help
+Transport Options:
+  --http, --sse        Start HTTP/SSE server instead of STDIO
+  --port <number>      HTTP server port (default: 3000)
+  --host <address>     HTTP server bind address (default: 0.0.0.0)
+
+General Options:
+  -v, --version        Show version number
+  -h, --help           Show help
 
 Environment Variables (override profile settings):
   F5XC_API_URL        Tenant URL (e.g., https://tenant.console.ves.volterra.io)
@@ -61,18 +66,47 @@ Profile Configuration (cross-compatible with f5xc-xcsh CLI):
   Profiles are stored in ~/.config/xcsh/profiles/
   Active profile is tracked in ~/.config/xcsh/active_profile
 
+Transport Modes:
+  STDIO (default)     For Claude Desktop, Claude CLI, VS Code extensions
+  HTTP/SSE            For vLLM servers, web-based clients, private LLM utilities
+
+Examples:
+  f5xc-api-mcp                           Start in STDIO mode (default)
+  f5xc-api-mcp --http                    Start HTTP server on 0.0.0.0:3000
+  f5xc-api-mcp --http --port 8080        Start HTTP server on port 8080
+  f5xc-api-mcp --http --host 127.0.0.1   Start HTTP server on localhost only
+
 The server runs in documentation mode when no credentials are provided,
 allowing exploration of the API without authentication.
 `);
             process.exit(0);
         }
-        // Start MCP server (default behavior)
+        // Parse HTTP mode flags
+        const httpMode = args.includes("--http") || args.includes("--sse");
+        const portIndex = args.indexOf("--port");
+        const portArg = portIndex !== -1 ? args[portIndex + 1] : undefined;
+        const port = portArg ? parseInt(portArg, 10) : 3000;
+        const hostIndex = args.indexOf("--host");
+        const host = hostIndex !== -1 && args[hostIndex + 1] ? args[hostIndex + 1] : "0.0.0.0";
+        // Start MCP server
         const server = await createServer();
-        await server.start();
+        if (httpMode) {
+            // Start in HTTP/SSE mode for vLLM and other HTTP clients
+            await server.startHttp({ port, host });
+        }
+        else {
+            // Start in STDIO mode (default) for Claude Desktop/CLI
+            await server.start();
+        }
         // Handle graceful shutdown
         const shutdown = async (signal) => {
             logger.info(`Received ${signal}, shutting down gracefully`);
-            await server.stop();
+            if (httpMode) {
+                await server.stopHttp();
+            }
+            else {
+                await server.stop();
+            }
             process.exit(0);
         };
         process.on("SIGINT", () => void shutdown("SIGINT"));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -6,6 +6,7 @@
  * execution mode (authenticated with F5XC credentials).
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type HttpServerOptions } from "./http-server.js";
 import { CredentialManager } from "./auth/credential-manager.js";
 /**
  * Server configuration options
@@ -32,6 +33,7 @@ export declare class F5XCApiServer {
     private httpClient;
     private resourceHandler;
     private transport;
+    private httpServer;
     constructor(config: ServerConfig);
     /**
      * Register all MCP capabilities (tools, resources, prompts)
@@ -59,9 +61,22 @@ export declare class F5XCApiServer {
      */
     start(): Promise<void>;
     /**
-     * Stop the MCP server
+     * Stop the MCP server (STDIO mode)
      */
     stop(): Promise<void>;
+    /**
+     * Start the MCP server with HTTP/SSE transport
+     *
+     * This mode enables integration with HTTP-based clients like vLLM
+     * servers and other AI utilities that communicate over HTTP.
+     *
+     * @param options - HTTP server configuration
+     */
+    startHttp(options?: HttpServerOptions): Promise<void>;
+    /**
+     * Stop the HTTP server
+     */
+    stopHttp(): Promise<void>;
     /**
      * Get the underlying MCP server instance
      */

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAY,MAAM,8BAA8B,CAAC;AA8C3E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,SAAS,CAAqC;gBAE1C,MAAM,EAAE,YAAY;IAmBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAwrBrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmCzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAuFvB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,oBAAoB,IAAI,iBAAiB;CAG1C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAS3D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAoC,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAY,MAAM,8BAA8B,CAAC;AA8C3E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,UAAU,CAA2B;gBAEjC,MAAM,EAAE,YAAY;IAmBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAwrBrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmCzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAuFvB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;;;;;;OAOG;IACG,SAAS,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB/B;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,oBAAoB,IAAI,iBAAiB;CAG1C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAS3D"}

package/dist/server.js

@@ -8,6 +8,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { setupHttpServer, cleanupSessions } from "./http-server.js";
 import { CredentialManager, AuthMode } from "./auth/credential-manager.js";
 import { createHttpClient } from "./auth/http-client.js";
 import { logger } from "./utils/logging.js";
@@ -30,6 +31,7 @@ export class F5XCApiServer {
     httpClient = null;
     resourceHandler;
     transport = null;
+    httpServer = null;
     constructor(config) {
         this.credentialManager = config.credentialManager;
         // Create HTTP client if authenticated
@@ -704,7 +706,7 @@ export class F5XCApiServer {
         logger.info("F5XC API MCP Server started successfully");
     }
     /**
-     * Stop the MCP server
+     * Stop the MCP server (STDIO mode)
      */
     async stop() {
         if (this.transport) {
@@ -713,6 +715,50 @@ export class F5XCApiServer {
             logger.info("F5XC API MCP Server stopped");
         }
     }
+    /**
+     * Start the MCP server with HTTP/SSE transport
+     *
+     * This mode enables integration with HTTP-based clients like vLLM
+     * servers and other AI utilities that communicate over HTTP.
+     *
+     * @param options - HTTP server configuration
+     */
+    async startHttp(options = {}) {
+        const { port = 3000, host = "0.0.0.0" } = options;
+        logger.info("Starting F5XC API MCP Server (HTTP mode)", {
+            version: VERSION,
+            authMode: this.credentialManager.getAuthMode(),
+            port,
+            host,
+        });
+        const result = await setupHttpServer(this.server, options);
+        this.httpServer = result.server;
+        logger.info("F5XC API MCP Server started successfully (HTTP mode)", {
+            url: `${result.address}/mcp`,
+            transport: "http/sse",
+        });
+    }
+    /**
+     * Stop the HTTP server
+     */
+    async stopHttp() {
+        if (this.httpServer) {
+            await cleanupSessions();
+            return new Promise((resolve, reject) => {
+                this.httpServer.close((err) => {
+                    if (err) {
+                        logger.error("Error stopping HTTP server", { error: err.message });
+                        reject(err);
+                    }
+                    else {
+                        this.httpServer = null;
+                        logger.info("F5XC API MCP HTTP Server stopped");
+                        resolve();
+                    }
+                });
+            });
+        }
+    }
     /**
      * Get the underlying MCP server instance
      */