@himanshusinghs/mongodb-mcp-server 1.7.7 → 1.11.0-prerelease.2

package/dist/cjs/transports/mcpHttpServer.js

@@ -0,0 +1,374 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultMcpHttpServer = exports.MCPHttpServer = void 0;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const express_1 = __importDefault(require("express"));
+const loggingDefinitions_js_1 = require("../common/logging/loggingDefinitions.js");
+const getRandomUUID_js_1 = require("../helpers/getRandomUUID.js");
+const configOverrides_js_1 = require("../common/config/configOverrides.js");
+const expressBasedHttpServer_js_1 = require("./expressBasedHttpServer.js");
+const jsonRpcErrorCodes_js_1 = require("./jsonRpcErrorCodes.js");
+class MCPHttpServer extends expressBasedHttpServer_js_1.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 jsonRpcErrorCodes_js_1.JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED:
+                message = "session id is required";
+                break;
+            case jsonRpcErrorCodes_js_1.JSON_RPC_ERROR_CODE_SESSION_ID_INVALID:
+                message = "session id is invalid";
+                break;
+            case jsonRpcErrorCodes_js_1.JSON_RPC_ERROR_CODE_INVALID_REQUEST:
+                message = "invalid request";
+                break;
+            case jsonRpcErrorCodes_js_1.JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND:
+                message = "session not found";
+                statusCode = 404;
+                break;
+            case jsonRpcErrorCodes_js_1.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: loggingDefinitions_js_1.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: loggingDefinitions_js_1.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 Promise.resolve().then(() => __importStar(require("@modelcontextprotocol/sdk/server/streamableHttp.js")));
+        const sessionId = providedSessionId ?? (0, getRandomUUID_js_1.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: loggingDefinitions_js_1.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: loggingDefinitions_js_1.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: loggingDefinitions_js_1.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: loggingDefinitions_js_1.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: loggingDefinitions_js_1.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_1.default.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, jsonRpcErrorCodes_js_1.JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED);
+            }
+            if (typeof sessionId !== "string") {
+                return this.reportSessionError(res, jsonRpcErrorCodes_js_1.JSON_RPC_ERROR_CODE_SESSION_ID_INVALID);
+            }
+            let transport = await this.sessionStore.getSession(sessionId);
+            if (!transport) {
+                if (!this.userConfig.externallyManagedSessions) {
+                    this.logger.debug({
+                        id: loggingDefinitions_js_1.LogId.streamableHttpTransportSessionNotFound,
+                        context: "streamableHttpTransport",
+                        message: `Session with ID ${sessionId} not found`,
+                    });
+                    return this.reportSessionError(res, jsonRpcErrorCodes_js_1.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, jsonRpcErrorCodes_js_1.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, jsonRpcErrorCodes_js_1.JSON_RPC_ERROR_CODE_SESSION_ID_INVALID);
+            }
+            if ((0, types_js_1.isInitializeRequest)(req.body)) {
+                if (sessionId && !this.userConfig.externallyManagedSessions) {
+                    this.logger.debug({
+                        id: loggingDefinitions_js_1.LogId.streamableHttpTransportDisallowedExternalSessionError,
+                        context: "streamableHttpTransport",
+                        message: `Client provided session ID ${sessionId}, but externallyManagedSessions is disabled`,
+                    });
+                    return this.reportSessionError(res, jsonRpcErrorCodes_js_1.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, jsonRpcErrorCodes_js_1.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, jsonRpcErrorCodes_js_1.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: loggingDefinitions_js_1.LogId.streamableHttpTransportRequestFailure,
+                    context: "streamableHttpTransport",
+                    message: `Error handling request: ${error instanceof Error ? error.message : String(error)}`,
+                });
+                const message = error instanceof configOverrides_js_1.ConfigOverrideError ? error.message : `failed to handle request`;
+                res.status(400).json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: jsonRpcErrorCodes_js_1.JSON_RPC_ERROR_CODE_PROCESSING_REQUEST_FAILED,
+                        message,
+                    },
+                });
+            });
+        };
+    }
+}
+exports.MCPHttpServer = MCPHttpServer;
+/**
+ * Creates a default MCPHttpServer instance from the provided constructor arguments.
+ */
+const createDefaultMcpHttpServer = (args) => new MCPHttpServer(args);
+exports.createDefaultMcpHttpServer = createDefaultMcpHttpServer;
+//# sourceMappingURL=mcpHttpServer.js.map

package/dist/cjs/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/cjs/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/cjs/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/cjs/transports/monitoringServer.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultMonitoringServer = exports.MonitoringServer = void 0;
+const loggingDefinitions_js_1 = require("../common/logging/loggingDefinitions.js");
+const expressBasedHttpServer_js_1 = require("./expressBasedHttpServer.js");
+class MonitoringServer extends expressBasedHttpServer_js_1.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: loggingDefinitions_js_1.LogId.monitoringServerMetricsFailure,
+                        context: "monitoringServer",
+                        message: `Failed to retrieve metrics: ${String(error)}`,
+                    });
+                    res.status(500).json({ error: "Failed to retrieve metrics" });
+                }
+            });
+        }
+        return Promise.resolve();
+    }
+}
+exports.MonitoringServer = MonitoringServer;
+/**
+ * Creates a default MonitoringServer instance from the provided constructor arguments.
+ */
+const createDefaultMonitoringServer = (args) => new MonitoringServer(args);
+exports.createDefaultMonitoringServer = createDefaultMonitoringServer;
+//# sourceMappingURL=monitoringServer.js.map

package/dist/cjs/transports/monitoringServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoringServer.js","sourceRoot":"","sources":["../../../src/transports/monitoringServer.ts"],"names":[],"mappings":";;;AACA,mFAAgE;AAShE,2EAAqE;AAErE,MAAa,gBAAmE,SAAQ,kDAAsB;IAI1G,YAAY,EACR,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,OAAO,GAOV;QACG,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,UAAU,CAAmD,EAChE,UAAU,EACV,MAAM,EACN,OAAO,GAKV;QACG,MAAM,IAAI,GAAG,UAAU,CAAC,oBAAoB,IAAI,UAAU,CAAC,eAAe,CAAC;QAC3E,MAAM,IAAI,GAAG,UAAU,CAAC,oBAAoB,IAAI,UAAU,CAAC,eAAe,CAAC;QAC3E,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3C,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,wBAAwB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAChH,CAAC;IAEkB,WAAW;QAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAqB,EAAE,GAAqB,EAAE,EAAE;gBACrE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;QACP,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;YAChE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,IAAqB,EAAE,GAAqB,EAAE,EAAE;gBAC5E,IAAI,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;oBAClC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;oBACtC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;wBACd,EAAE,EAAE,6BAAK,CAAC,8BAA8B;wBACxC,OAAO,EAAE,kBAAkB;wBAC3B,OAAO,EAAE,+BAA+B,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC1D,CAAC,CAAC;oBACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;gBAClE,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;CACJ;AAnED,4CAmEC;AAUD;;GAEG;AACI,MAAM,6BAA6B,GAER,CAC9B,IAA+C,EACjD,EAAE,CAAC,IAAI,gBAAgB,CAAW,IAAI,CAAC,CAAC;AAJ7B,QAAA,6BAA6B,iCAIA"}

package/dist/cjs/transports/stdio.d.ts

@@ -2,9 +2,10 @@ import type { CustomizableServerOptions } from "./base.js";
 import type { CustomizableSessionOptions } from "./base.js";
 import { TransportRunnerBase, type TransportRunnerConfig } from "./base.js";
 import type { UserConfig } from "../lib.js";
-export declare class StdioRunner<TUserConfig extends UserConfig = UserConfig, TContext = unknown> extends TransportRunnerBase<TUserConfig, TContext> {
+import type { DefaultMetrics } from "@mongodb-js/mcp-metrics";
+export declare class StdioRunner<TUserConfig extends UserConfig = UserConfig, TContext = unknown, TMetrics extends DefaultMetrics = DefaultMetrics> extends TransportRunnerBase<TUserConfig, TContext, TMetrics> {
     private server;
-    constructor(config: TransportRunnerConfig<TUserConfig>);
+    constructor(config: TransportRunnerConfig<TUserConfig, TMetrics>);
     start({ serverOptions, sessionOptions, }?: {
         serverOptions?: CustomizableServerOptions<TUserConfig, TContext>;
         sessionOptions?: CustomizableSessionOptions<TUserConfig>;

package/dist/cjs/transports/stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,qBAAa,WAAW,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAE,SAAQ,mBAAmB,CACjH,WAAW,EACX,QAAQ,CACX;IACG,OAAO,CAAC,MAAM,CAA4C;gBAE9C,MAAM,EAAE,qBAAqB,CAAC,WAAW,CAAC;IAIhD,KAAK,CAAC,EACR,aAAa,EACb,cAAc,GACjB,GAAE;QACC,aAAa,CAAC,EAAE,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjE,cAAc,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;KACvD,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAGxC"}
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,qBAAa,WAAW,CACpB,WAAW,SAAS,UAAU,GAAG,UAAU,EAC3C,QAAQ,GAAG,OAAO,EAClB,QAAQ,SAAS,cAAc,GAAG,cAAc,CAClD,SAAQ,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC1D,OAAO,CAAC,MAAM,CAA4C;gBAE9C,MAAM,EAAE,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC;IAI1D,KAAK,CAAC,EACR,aAAa,EACb,cAAc,GACjB,GAAE;QACC,aAAa,CAAC,EAAE,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjE,cAAc,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;KACvD,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/cjs/transports/stdio.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StdioRunner = void 0;
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const logger_js_1 = require("../common/logger.js");
+const index_js_1 = require("../common/logging/index.js");
 const base_js_1 = require("./base.js");
 class StdioRunner extends base_js_1.TransportRunnerBase {
     constructor(config) {
@@ -16,7 +16,7 @@ class StdioRunner extends base_js_1.TransportRunnerBase {
         }
         catch (error) {
             this.logger.emergency({
-                id: logger_js_1.LogId.serverStartFailure,
+                id: index_js_1.LogId.serverStartFailure,
                 context: "server",
                 message: `Fatal error running server: ${error}`,
             });

package/dist/cjs/transports/stdio.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":";;;AAAA,wEAAiF;AACjF,mDAA4C;AAI5C,uCAA4E;AAG5E,MAAa,WAA6E,SAAQ,6BAGjG;IAGG,YAAY,MAA0C;QAClD,KAAK,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,EACR,aAAa,EACb,cAAc,MAId,EAAE;QACF,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;YAE7C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;gBAClB,EAAE,EAAE,iBAAK,CAAC,kBAAkB;gBAC5B,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,+BAA+B,KAAe,EAAE;aAC5D,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc;QAChB,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;CACJ;AAnCD,kCAmCC"}
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":";;;AAAA,wEAAiF;AACjF,yDAAmD;AAInD,uCAA4E;AAI5E,MAAa,WAIX,SAAQ,6BAAoD;IAG1D,YAAY,MAAoD;QAC5D,KAAK,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,EACR,aAAa,EACb,cAAc,MAId,EAAE;QACF,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;YAE7C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;gBAClB,EAAE,EAAE,gBAAK,CAAC,kBAAkB;gBAC5B,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,+BAA+B,KAAe,EAAE;aAC5D,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc;QAChB,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;CACJ;AApCD,kCAoCC"}

package/dist/cjs/transports/streamableHttp/httpServers/expressBasedHttpServer.d.ts

@@ -0,0 +1,24 @@
+import express from "express";
+import type http from "http";
+import { type LoggerBase } from "../../../common/logging/index.js";
+type ExpressConfig = {
+    port: number;
+    hostname: string;
+};
+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>;
+}
+export {};
+//# sourceMappingURL=expressBasedHttpServer.d.ts.map

package/dist/cjs/transports/streamableHttp/httpServers/expressBasedHttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressBasedHttpServer.d.ts","sourceRoot":"","sources":["../../../../../src/transports/streamableHttp/httpServers/expressBasedHttpServer.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,KAAK,UAAU,EAAS,MAAM,kCAAkC,CAAC;AAE1E,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,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/cjs/transports/streamableHttp/httpServers/expressBasedHttpServer.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressBasedHttpServer = void 0;
+const express_1 = __importDefault(require("express"));
+const index_js_1 = require("../../../common/logging/index.js");
+class ExpressBasedHttpServer {
+    constructor(config) {
+        this.app = (0, express_1.default)();
+        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: index_js_1.LogId.httpServerStarted,
+        });
+    }
+    async stop() {
+        if (this.httpServer) {
+            this.logger.info({
+                message: "Stopping server...",
+                context: this.logContext,
+                id: index_js_1.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: index_js_1.LogId.httpServerStopped,
+            });
+        }
+        else {
+            this.logger.info({
+                message: "Server is not running",
+                context: this.logContext,
+                id: index_js_1.LogId.httpServerStopped,
+            });
+        }
+    }
+}
+exports.ExpressBasedHttpServer = ExpressBasedHttpServer;
+//# sourceMappingURL=expressBasedHttpServer.js.map