@himanshusinghs/mongodb-mcp-server 1.8.0 → 1.11.0-prerelease.3

package/dist/esm/transports/expressBasedHttpServer.d.ts

@@ -0,0 +1,24 @@
+import express from "express";
+import type http from "http";
+import type { LoggerBase } from "../lib.js";
+export type ExpressConfig = {
+    port: number;
+    hostname: string;
+};
+/** @internal */
+export declare abstract class ExpressBasedHttpServer {
+    protected httpServer: http.Server | undefined;
+    protected app: express.Express;
+    protected readonly logger: LoggerBase;
+    protected readonly logContext: string;
+    protected readonly expressConfig: ExpressConfig;
+    constructor(config: {
+        logger: LoggerBase;
+        logContext: string;
+    } & ExpressConfig);
+    get serverAddress(): string;
+    protected abstract setupRoutes(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=expressBasedHttpServer.d.ts.map

package/dist/esm/transports/expressBasedHttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressBasedHttpServer.d.ts","sourceRoot":"","sources":["../../../src/transports/expressBasedHttpServer.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,gBAAgB;AAChB,8BAAsB,sBAAsB;IACxC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;IAE/B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAEtC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;gBAEpC,MAAM,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa;IAS9E,IAAW,aAAa,IAAI,MAAM,CAUjC;IAED,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAgCrC"}

package/dist/esm/transports/expressBasedHttpServer.js

@@ -0,0 +1,75 @@
+import express from "express";
+import { LogId } from "../common/logging/loggingDefinitions.js";
+/** @internal */
+export class ExpressBasedHttpServer {
+    constructor(config) {
+        this.app = express();
+        this.app.enable("trust proxy"); // needed for reverse proxy support
+        this.expressConfig = { port: config.port, hostname: config.hostname };
+        this.logger = config.logger;
+        this.logContext = config.logContext;
+    }
+    get serverAddress() {
+        const result = this.httpServer?.address();
+        if (typeof result === "string") {
+            return result;
+        }
+        if (typeof result === "object" && result) {
+            return `http://${result.address}:${result.port}`;
+        }
+        throw new Error("Server is not started yet");
+    }
+    async start() {
+        await this.setupRoutes();
+        const { port, hostname } = this.expressConfig;
+        this.httpServer = await new Promise((resolve, reject) => {
+            const result = this.app.listen(port, hostname, (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(result);
+                }
+            });
+        });
+        this.logger.info({
+            message: `Http server started on address: ${this.serverAddress}`,
+            context: this.logContext,
+            noRedaction: true,
+            id: LogId.httpServerStarted,
+        });
+    }
+    async stop() {
+        if (this.httpServer) {
+            this.logger.info({
+                message: "Stopping server...",
+                context: this.logContext,
+                id: LogId.httpServerStopping,
+            });
+            const server = this.httpServer;
+            await new Promise((resolve, reject) => {
+                server.close((err) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        resolve(undefined);
+                    }
+                });
+            });
+            this.logger.info({
+                message: "Server stopped",
+                context: this.logContext,
+                id: LogId.httpServerStopped,
+            });
+        }
+        else {
+            this.logger.info({
+                message: "Server is not running",
+                context: this.logContext,
+                id: LogId.httpServerStopped,
+            });
+        }
+    }
+}
+//# sourceMappingURL=expressBasedHttpServer.js.map

package/dist/esm/transports/expressBasedHttpServer.js.map

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

package/dist/esm/transports/jsonRpcErrorCodes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JSON-RPC error codes for the MCP HTTP server.
+ * These are defined in a separate module to avoid circular dependencies
+ * between streamableHttp.ts and mcpHttpServer.ts.
+ */
+export declare const JSON_RPC_ERROR_CODE_PROCESSING_REQUEST_FAILED = -32000;
+export declare const JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED = -32001;
+export declare const JSON_RPC_ERROR_CODE_SESSION_ID_INVALID = -32002;
+export declare const JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND = -32003;
+export declare const JSON_RPC_ERROR_CODE_INVALID_REQUEST = -32004;
+export declare const JSON_RPC_ERROR_CODE_DISALLOWED_EXTERNAL_SESSION = -32005;
+//# sourceMappingURL=jsonRpcErrorCodes.d.ts.map

package/dist/esm/transports/jsonRpcErrorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonRpcErrorCodes.d.ts","sourceRoot":"","sources":["../../../src/transports/jsonRpcErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,6CAA6C,SAAS,CAAC;AACpE,eAAO,MAAM,uCAAuC,SAAS,CAAC;AAC9D,eAAO,MAAM,sCAAsC,SAAS,CAAC;AAC7D,eAAO,MAAM,qCAAqC,SAAS,CAAC;AAC5D,eAAO,MAAM,mCAAmC,SAAS,CAAC;AAC1D,eAAO,MAAM,+CAA+C,SAAS,CAAC"}

package/dist/esm/transports/jsonRpcErrorCodes.js

@@ -0,0 +1,12 @@
+/**
+ * JSON-RPC error codes for the MCP HTTP server.
+ * These are defined in a separate module to avoid circular dependencies
+ * between streamableHttp.ts and mcpHttpServer.ts.
+ */
+export const JSON_RPC_ERROR_CODE_PROCESSING_REQUEST_FAILED = -32000;
+export const JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED = -32001;
+export const JSON_RPC_ERROR_CODE_SESSION_ID_INVALID = -32002;
+export const JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND = -32003;
+export const JSON_RPC_ERROR_CODE_INVALID_REQUEST = -32004;
+export const JSON_RPC_ERROR_CODE_DISALLOWED_EXTERNAL_SESSION = -32005;
+//# sourceMappingURL=jsonRpcErrorCodes.js.map

package/dist/esm/transports/jsonRpcErrorCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonRpcErrorCodes.js","sourceRoot":"","sources":["../../../src/transports/jsonRpcErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,6CAA6C,GAAG,CAAC,KAAK,CAAC;AACpE,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,KAAK,CAAC;AAC9D,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,KAAK,CAAC;AAC7D,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,KAAK,CAAC;AAC5D,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,KAAK,CAAC;AAC1D,MAAM,CAAC,MAAM,+CAA+C,GAAG,CAAC,KAAK,CAAC"}

package/dist/esm/transports/mcpHttpServer.d.ts

@@ -0,0 +1,61 @@
+import { type StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { type UserConfig, type ISessionStore, type Metrics, type DefaultMetrics, type Server, type LoggerBase } from "../lib.js";
+import type { CustomizableServerOptions, CustomizableSessionOptions, TransportRequestContext } from "./base.js";
+import { ExpressBasedHttpServer } from "./expressBasedHttpServer.js";
+export type MCPHttpServerConstructorArgs<TUserConfig extends UserConfig = UserConfig, TContext = unknown> = {
+    userConfig: TUserConfig;
+    createServerForRequest: (createParams: {
+        request: TransportRequestContext;
+        serverOptions?: CustomizableServerOptions<TUserConfig, TContext>;
+        sessionOptions?: CustomizableSessionOptions<TUserConfig>;
+    }) => Promise<Server<TUserConfig, TContext>>;
+    logger: LoggerBase;
+    serverOptions?: CustomizableServerOptions<TUserConfig, TContext>;
+    sessionOptions?: CustomizableSessionOptions<TUserConfig>;
+    metrics: Metrics<DefaultMetrics>;
+    sessionStore: ISessionStore<StreamableHTTPServerTransport>;
+};
+export declare class MCPHttpServer<TUserConfig extends UserConfig = UserConfig, TContext = unknown> extends ExpressBasedHttpServer {
+    protected readonly sessionStore: ISessionStore<StreamableHTTPServerTransport>;
+    private readonly serverOptions?;
+    private readonly sessionOptions?;
+    protected readonly userConfig: TUserConfig;
+    private readonly metrics;
+    private readonly pendingInitializations;
+    private createServerForRequest;
+    constructor({ userConfig, createServerForRequest, serverOptions, sessionOptions, logger, metrics, sessionStore, }: MCPHttpServerConstructorArgs<TUserConfig, TContext>);
+    stop(): Promise<void>;
+    private reportSessionError;
+    private startKeepAliveLoop;
+    /**
+     * Ensures the session for the given sessionId is initialized, serializing
+     * concurrent initialization attempts so only one runs at a time.
+     *
+     * If a session already exists in the store, this is a no-op.
+     * If another request is already initializing this session, this call waits
+     * for that initialization to complete.
+     * Otherwise, this call performs the initialization.
+     *
+     * After this method resolves, the caller should look up the transport from
+     * the session store via `sessionStore.getSession()`.
+     *
+     * When `isImplicitInitialization` is true, the transport is pre-configured as
+     * initialized (bypassing the MCP initialize handshake) so that it can handle
+     * non-initialize requests immediately. When false, the transport is left in
+     * its default state so it can process the initialize request normally.
+     */
+    private ensureSessionInitialized;
+    protected setupMiddlewares(): void;
+    protected setupRoutes(): Promise<void>;
+    private withErrorHandling;
+}
+/**
+ * A function to create a custom MCPHttpServer instance.
+ * When provided, the runner will use this function instead of the default MCPHttpServer constructor.
+ */
+export type CreateMcpHttpServerFn<TUserConfig extends UserConfig = UserConfig, TContext = unknown> = (args: MCPHttpServerConstructorArgs<TUserConfig, TContext>) => MCPHttpServer<TUserConfig, TContext>;
+/**
+ * Creates a default MCPHttpServer instance from the provided constructor arguments.
+ */
+export declare const createDefaultMcpHttpServer: <TUserConfig extends UserConfig = UserConfig, TContext = unknown>(args: MCPHttpServerConstructorArgs<TUserConfig, TContext>) => MCPHttpServer<TUserConfig, TContext>;
+//# sourceMappingURL=mcpHttpServer.d.ts.map

package/dist/esm/transports/mcpHttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpHttpServer.d.ts","sourceRoot":"","sources":["../../../src/transports/mcpHttpServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAKxG,OAAO,EACH,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,UAAU,EAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAChH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAUrE,MAAM,MAAM,4BAA4B,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,GAAG,OAAO,IAAI;IACxG,UAAU,EAAE,WAAW,CAAC;IACxB,sBAAsB,EAAE,CAAC,YAAY,EAAE;QACnC,OAAO,EAAE,uBAAuB,CAAC;QACjC,aAAa,CAAC,EAAE,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjE,cAAc,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;KAC5D,KAAK,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACjE,cAAc,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACzD,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,YAAY,EAAE,aAAa,CAAC,6BAA6B,CAAC,CAAC;CAC9D,CAAC;AAEF,qBAAa,aAAa,CACtB,WAAW,SAAS,UAAU,GAAG,UAAU,EAC3C,QAAQ,GAAG,OAAO,CACpB,SAAQ,sBAAsB;IAC5B,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,6BAA6B,CAAC,CAAC;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAmD;IAClF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA0C;IAC1E,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoC;IAE3E,OAAO,CAAC,sBAAsB,CAIe;gBAEjC,EACR,UAAU,EACV,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,MAAM,EACN,OAAO,EACP,YAAY,GACf,EAAE,4BAA4B,CAAC,WAAW,EAAE,QAAQ,CAAC;IAezC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,kBAAkB;IA+C1B;;;;;;;;;;;;;;;;OAgBG;YACW,wBAAwB;IA4HtC,SAAS,CAAC,gBAAgB,IAAI,IAAI;cAgBT,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA4FrD,OAAO,CAAC,iBAAiB;CAuB5B;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,GAAG,OAAO,IAAI,CACjG,IAAI,EAAE,4BAA4B,CAAC,WAAW,EAAE,QAAQ,CAAC,KACxD,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,WAAW,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,GAAG,OAAO,EACtG,MAAM,4BAA4B,CAAC,WAAW,EAAE,QAAQ,CAAC,KAC1D,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAmD,CAAC"}

package/dist/esm/transports/mcpHttpServer.js

@@ -0,0 +1,333 @@
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import express from "express";
+import { LogId } from "../common/logging/loggingDefinitions.js";
+import { getRandomUUID } from "../helpers/getRandomUUID.js";
+import { ConfigOverrideError } from "../common/config/configOverrides.js";
+import { ExpressBasedHttpServer } from "./expressBasedHttpServer.js";
+import { JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED, JSON_RPC_ERROR_CODE_SESSION_ID_INVALID, JSON_RPC_ERROR_CODE_INVALID_REQUEST, JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND, JSON_RPC_ERROR_CODE_DISALLOWED_EXTERNAL_SESSION, JSON_RPC_ERROR_CODE_PROCESSING_REQUEST_FAILED, } from "./jsonRpcErrorCodes.js";
+export class MCPHttpServer extends ExpressBasedHttpServer {
+    constructor({ userConfig, createServerForRequest, serverOptions, sessionOptions, logger, metrics, sessionStore, }) {
+        super({
+            port: userConfig.httpPort,
+            hostname: userConfig.httpHost,
+            logger,
+            logContext: "mcpHttpServer",
+        });
+        this.pendingInitializations = new Map();
+        this.serverOptions = serverOptions;
+        this.sessionOptions = sessionOptions;
+        this.createServerForRequest = createServerForRequest;
+        this.userConfig = userConfig;
+        this.metrics = metrics;
+        this.sessionStore = sessionStore;
+    }
+    async stop() {
+        await Promise.all([this.sessionStore.closeAllSessions(), super.stop()]);
+    }
+    reportSessionError(res, errorCode) {
+        let message;
+        let statusCode = 400;
+        switch (errorCode) {
+            case JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED:
+                message = "session id is required";
+                break;
+            case JSON_RPC_ERROR_CODE_SESSION_ID_INVALID:
+                message = "session id is invalid";
+                break;
+            case JSON_RPC_ERROR_CODE_INVALID_REQUEST:
+                message = "invalid request";
+                break;
+            case JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND:
+                message = "session not found";
+                statusCode = 404;
+                break;
+            case JSON_RPC_ERROR_CODE_DISALLOWED_EXTERNAL_SESSION:
+                message = "cannot provide sessionId when externally managed sessions are disabled";
+                break;
+            default:
+                message = "unknown error";
+                statusCode = 500;
+        }
+        res.status(statusCode).json({
+            jsonrpc: "2.0",
+            error: {
+                code: errorCode,
+                message,
+            },
+        });
+    }
+    startKeepAliveLoop(transport, server) {
+        if (this.userConfig.httpResponseType === "json") {
+            // Don't start the ping loop for JSON response type since the connection is short-lived and pings aren't needed
+            return undefined;
+        }
+        let failedPings = 0;
+        // eslint-disable-next-line @typescript-eslint/no-misused-promises
+        const keepAliveLoop = setInterval(async () => {
+            try {
+                server.session.logger.debug({
+                    id: LogId.streamableHttpTransportKeepAlive,
+                    context: "streamableHttpTransport",
+                    message: "Sending ping",
+                });
+                await transport.send({
+                    jsonrpc: "2.0",
+                    method: "ping",
+                });
+                failedPings = 0;
+            }
+            catch (err) {
+                try {
+                    failedPings++;
+                    server.session.logger.warning({
+                        id: LogId.streamableHttpTransportKeepAliveFailure,
+                        context: "streamableHttpTransport",
+                        message: `Error sending ping (attempt #${failedPings}): ${err instanceof Error ? err.message : String(err)}`,
+                    });
+                    if (failedPings > 3) {
+                        clearInterval(keepAliveLoop);
+                        await transport.close();
+                    }
+                }
+                catch {
+                    // Ignore the error of the transport close as there's nothing else
+                    // we can do at this point.
+                }
+            }
+        }, 30000);
+        return keepAliveLoop;
+    }
+    /**
+     * Ensures the session for the given sessionId is initialized, serializing
+     * concurrent initialization attempts so only one runs at a time.
+     *
+     * If a session already exists in the store, this is a no-op.
+     * If another request is already initializing this session, this call waits
+     * for that initialization to complete.
+     * Otherwise, this call performs the initialization.
+     *
+     * After this method resolves, the caller should look up the transport from
+     * the session store via `sessionStore.getSession()`.
+     *
+     * When `isImplicitInitialization` is true, the transport is pre-configured as
+     * initialized (bypassing the MCP initialize handshake) so that it can handle
+     * non-initialize requests immediately. When false, the transport is left in
+     * its default state so it can process the initialize request normally.
+     */
+    async ensureSessionInitialized({ req, sessionId: providedSessionId, isImplicitInitialization, }) {
+        /** StreamableHTTPTransport needs to be imported dynamically as it uses Node-specific APIs */
+        const { StreamableHTTPServerTransport } = await import("@modelcontextprotocol/sdk/server/streamableHttp.js");
+        const sessionId = providedSessionId ?? getRandomUUID();
+        // Check if session already exists
+        if (await this.sessionStore.getSession(sessionId)) {
+            return sessionId;
+        }
+        // Serialize initializations: if another request is initializing, wait for it
+        const pendingInit = this.pendingInitializations.get(sessionId);
+        if (pendingInit) {
+            this.logger.debug({
+                id: LogId.streamableHttpTransportSessionNotFound,
+                context: "streamableHttpTransport",
+                message: `Session with ID ${sessionId} is already being initialized, waiting`,
+            });
+            try {
+                await pendingInit;
+            }
+            catch {
+                // The initializer handles its own error; we just need to
+                // let the caller re-check the store.
+            }
+            return sessionId;
+        }
+        this.logger.debug({
+            id: LogId.streamableHttpTransportSessionNotFound,
+            context: "streamableHttpTransport",
+            message: `Session with ID ${sessionId} not found, initializing new session`,
+        });
+        const initPromise = (async () => {
+            const request = {
+                headers: req.headers,
+                query: req.query,
+            };
+            const server = await this.createServerForRequest({
+                request,
+                serverOptions: this.serverOptions,
+                sessionOptions: this.sessionOptions,
+            });
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => sessionId,
+                enableJsonResponse: this.userConfig.httpResponseType === "json",
+                onsessionclosed: async (sessionId) => {
+                    try {
+                        await this.sessionStore.closeSession({ sessionId, reason: "transport_closed" });
+                    }
+                    catch (error) {
+                        this.logger.error({
+                            id: LogId.streamableHttpTransportSessionCloseFailure,
+                            context: "streamableHttpTransport",
+                            message: `Error closing session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`,
+                        });
+                    }
+                },
+            });
+            // HACK: When we're implicitly initializing the session, we want to configure the session id and _initialized flag on the transport
+            // so that it believes it actually went through the initialization flow. Without it, we'd get errors like "transport not initialized"
+            // when we try to use it without initialize request
+            if (isImplicitInitialization) {
+                const internalTransport = transport["_webStandardTransport"];
+                internalTransport._initialized = true;
+                internalTransport.sessionId = sessionId;
+            }
+            server.session.logger.setAttribute("sessionId", sessionId);
+            const keepAliveLoop = this.startKeepAliveLoop(transport, server);
+            transport.onclose = () => {
+                clearInterval(keepAliveLoop);
+                server.close().catch((error) => {
+                    this.logger.error({
+                        id: LogId.streamableHttpTransportCloseFailure,
+                        context: "streamableHttpTransport",
+                        message: `Error closing server: ${error instanceof Error ? error.message : String(error)}`,
+                    });
+                });
+            };
+            await server.connect(transport);
+            await this.sessionStore.addSession({ sessionId, transport, logger: server.session.logger });
+        })();
+        this.pendingInitializations.set(sessionId, initPromise);
+        try {
+            await initPromise;
+        }
+        catch (error) {
+            this.logger.error({
+                id: LogId.streamableHttpTransportRequestFailure,
+                context: "streamableHttpTransport",
+                message: `Failed to initialize session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            // Remove the partially initialized session on failure so that
+            // subsequent requests don't see a broken session and can retry
+            try {
+                await this.sessionStore.closeSession({ sessionId, reason: "unknown" });
+            }
+            catch {
+                // Session might not be in the store, that's fine
+            }
+            throw error;
+        }
+        finally {
+            this.pendingInitializations.delete(sessionId);
+        }
+        return sessionId;
+    }
+    setupMiddlewares() {
+        this.app.use(express.json({ limit: this.userConfig.httpBodyLimit }));
+        this.app.use((req, res, next) => {
+            for (const [key, value] of Object.entries(this.userConfig.httpHeaders)) {
+                const header = req.headers[key.toLowerCase()];
+                if (!header || header !== value) {
+                    res.status(403).json({ error: `Invalid value for header "${key}"` });
+                    return;
+                }
+            }
+            next();
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async setupRoutes() {
+        this.setupMiddlewares();
+        const handleSessionRequest = async (req, res) => {
+            const sessionId = req.headers["mcp-session-id"];
+            if (!sessionId) {
+                return this.reportSessionError(res, JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED);
+            }
+            if (typeof sessionId !== "string") {
+                return this.reportSessionError(res, JSON_RPC_ERROR_CODE_SESSION_ID_INVALID);
+            }
+            let transport = await this.sessionStore.getSession(sessionId);
+            if (!transport) {
+                if (!this.userConfig.externallyManagedSessions) {
+                    this.logger.debug({
+                        id: LogId.streamableHttpTransportSessionNotFound,
+                        context: "streamableHttpTransport",
+                        message: `Session with ID ${sessionId} not found`,
+                    });
+                    return this.reportSessionError(res, JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND);
+                }
+                const resolvedSessionId = await this.ensureSessionInitialized({
+                    req,
+                    sessionId,
+                    isImplicitInitialization: true,
+                });
+                transport = await this.sessionStore.getSession(resolvedSessionId);
+                if (!transport) {
+                    return this.reportSessionError(res, JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND);
+                }
+            }
+            await transport.handleRequest(req, res, req.body);
+        };
+        this.app.post("/mcp", this.withErrorHandling(async (req, res) => {
+            const sessionId = req.headers["mcp-session-id"];
+            if (sessionId && typeof sessionId !== "string") {
+                return this.reportSessionError(res, JSON_RPC_ERROR_CODE_SESSION_ID_INVALID);
+            }
+            if (isInitializeRequest(req.body)) {
+                if (sessionId && !this.userConfig.externallyManagedSessions) {
+                    this.logger.debug({
+                        id: LogId.streamableHttpTransportDisallowedExternalSessionError,
+                        context: "streamableHttpTransport",
+                        message: `Client provided session ID ${sessionId}, but externallyManagedSessions is disabled`,
+                    });
+                    return this.reportSessionError(res, JSON_RPC_ERROR_CODE_DISALLOWED_EXTERNAL_SESSION);
+                }
+                const resolvedSessionId = await this.ensureSessionInitialized({
+                    req,
+                    sessionId,
+                    isImplicitInitialization: false,
+                });
+                const transport = await this.sessionStore.getSession(resolvedSessionId);
+                if (!transport) {
+                    return this.reportSessionError(res, JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND);
+                }
+                await transport.handleRequest(req, res, req.body);
+                return;
+            }
+            if (sessionId) {
+                return await handleSessionRequest(req, res);
+            }
+            return this.reportSessionError(res, JSON_RPC_ERROR_CODE_INVALID_REQUEST);
+        }));
+        this.app.get("/mcp", this.withErrorHandling(async (req, res) => {
+            if (this.userConfig.httpResponseType === "sse") {
+                await handleSessionRequest(req, res);
+            }
+            else {
+                // Don't allow SSE upgrades if the response type is JSON
+                res.status(405).set("Allow", ["POST", "DELETE"]).send("Method Not Allowed");
+            }
+        }));
+        this.app.delete("/mcp", this.withErrorHandling(handleSessionRequest));
+    }
+    withErrorHandling(fn) {
+        return (req, res, next) => {
+            fn(req, res, next).catch((error) => {
+                this.logger.error({
+                    id: LogId.streamableHttpTransportRequestFailure,
+                    context: "streamableHttpTransport",
+                    message: `Error handling request: ${error instanceof Error ? error.message : String(error)}`,
+                });
+                const message = error instanceof ConfigOverrideError ? error.message : `failed to handle request`;
+                res.status(400).json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: JSON_RPC_ERROR_CODE_PROCESSING_REQUEST_FAILED,
+                        message,
+                    },
+                });
+            });
+        };
+    }
+}
+/**
+ * Creates a default MCPHttpServer instance from the provided constructor arguments.
+ */
+export const createDefaultMcpHttpServer = (args) => new MCPHttpServer(args);
+//# sourceMappingURL=mcpHttpServer.js.map

package/dist/esm/transports/mcpHttpServer.js.map

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

package/dist/esm/transports/monitoringServer.d.ts

@@ -0,0 +1,29 @@
+import type { DefaultMetrics, MonitoringServerFeature, Metrics, LoggerBase, UserConfig, MonitoringServerConstructorArgs } from "../lib.js";
+import { ExpressBasedHttpServer } from "./expressBasedHttpServer.js";
+export declare class MonitoringServer<TMetrics extends DefaultMetrics = DefaultMetrics> extends ExpressBasedHttpServer {
+    private readonly features;
+    private readonly metrics;
+    constructor({ host, port, features, logger, metrics, }: {
+        host: string;
+        port: number;
+        features: MonitoringServerFeature[];
+        logger: LoggerBase;
+        metrics: Metrics<TMetrics>;
+    });
+    static fromConfig<TMetrics extends DefaultMetrics = DefaultMetrics>({ userConfig, logger, metrics, }: {
+        userConfig: UserConfig;
+        logger: LoggerBase;
+        metrics: Metrics<TMetrics>;
+    }): MonitoringServer<TMetrics> | undefined;
+    protected setupRoutes(): Promise<void>;
+}
+/**
+ * A function to create a custom MonitoringServer instance.
+ * When provided, the runner will use this function instead of the default MonitoringServer constructor.
+ */
+export type CreateMonitoringServerFn<TMetrics extends DefaultMetrics = DefaultMetrics> = (args: MonitoringServerConstructorArgs<TMetrics>) => MonitoringServer<TMetrics> | undefined;
+/**
+ * Creates a default MonitoringServer instance from the provided constructor arguments.
+ */
+export declare const createDefaultMonitoringServer: <TMetrics extends DefaultMetrics = DefaultMetrics>(args: MonitoringServerConstructorArgs<TMetrics>) => MonitoringServer<TMetrics>;
+//# sourceMappingURL=monitoringServer.d.ts.map

package/dist/esm/transports/monitoringServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoringServer.d.ts","sourceRoot":"","sources":["../../../src/transports/monitoringServer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,cAAc,EACd,uBAAuB,EACvB,OAAO,EACP,UAAU,EACV,UAAU,EACV,+BAA+B,EAClC,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,qBAAa,gBAAgB,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,sBAAsB;IAC1G,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,EACR,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,OAAO,GACV,EAAE;QACC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,uBAAuB,EAAE,CAAC;QACpC,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;KAC9B;IAMD,MAAM,CAAC,UAAU,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,EAAE,EAChE,UAAU,EACV,MAAM,EACN,OAAO,GACV,EAAE;QACC,UAAU,EAAE,UAAU,CAAC;QACvB,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;KAC9B,GAAG,gBAAgB,CAAC,QAAQ,CAAC,GAAG,SAAS;cAUvB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CA2BlD;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,IAAI,CACrF,IAAI,EAAE,+BAA+B,CAAC,QAAQ,CAAC,KAC9C,gBAAgB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,EACzF,IAAI,EAAE,+BAA+B,CAAC,QAAQ,CAAC,KAC9C,gBAAgB,CAAC,QAAQ,CAEW,CAAC"}

package/dist/esm/transports/monitoringServer.js

@@ -0,0 +1,48 @@
+import { LogId } from "../common/logging/loggingDefinitions.js";
+import { ExpressBasedHttpServer } from "./expressBasedHttpServer.js";
+export class MonitoringServer extends ExpressBasedHttpServer {
+    constructor({ host, port, features, logger, metrics, }) {
+        super({ port, hostname: host, logger, logContext: "monitoringServer" });
+        this.features = features;
+        this.metrics = metrics;
+    }
+    static fromConfig({ userConfig, logger, metrics, }) {
+        const host = userConfig.monitoringServerHost ?? userConfig.healthCheckHost;
+        const port = userConfig.monitoringServerPort ?? userConfig.healthCheckPort;
+        if (host === undefined || port === undefined) {
+            return undefined;
+        }
+        return new MonitoringServer({ host, port, features: userConfig.monitoringServerFeatures, logger, metrics });
+    }
+    setupRoutes() {
+        if (this.features.includes("health-check")) {
+            this.app.get("/health", (_req, res) => {
+                res.json({ status: "ok" });
+            });
+        }
+        if (this.features.includes("metrics") && this.metrics?.getMetrics) {
+            const getMetrics = this.metrics.getMetrics.bind(this.metrics);
+            this.app.get("/metrics", async (_req, res) => {
+                try {
+                    const output = await getMetrics();
+                    res.set("Content-Type", "text/plain");
+                    res.send(output);
+                }
+                catch (error) {
+                    this.logger.error({
+                        id: LogId.monitoringServerMetricsFailure,
+                        context: "monitoringServer",
+                        message: `Failed to retrieve metrics: ${String(error)}`,
+                    });
+                    res.status(500).json({ error: "Failed to retrieve metrics" });
+                }
+            });
+        }
+        return Promise.resolve();
+    }
+}
+/**
+ * Creates a default MonitoringServer instance from the provided constructor arguments.
+ */
+export const createDefaultMonitoringServer = (args) => new MonitoringServer(args);
+//# sourceMappingURL=monitoringServer.js.map