@himanshusinghs/mongodb-mcp-server 0.3.0

package/dist/esm/helpers/indexCheck.js

@@ -0,0 +1,63 @@
+import { ErrorCodes, MongoDBError } from "../common/errors.js";
+/**
+ * Check if the query plan uses an index
+ * @param explainResult The result of the explain query
+ * @returns true if an index is used, false if it's a full collection scan
+ */
+export function usesIndex(explainResult) {
+    const queryPlanner = explainResult?.queryPlanner;
+    const winningPlan = queryPlanner?.winningPlan;
+    const stage = winningPlan?.stage;
+    const inputStage = winningPlan?.inputStage;
+    // Check for index scan stages (including MongoDB 8.0+ stages)
+    const indexScanStages = [
+        "IXSCAN",
+        "COUNT_SCAN",
+        "EXPRESS_IXSCAN",
+        "EXPRESS_CLUSTERED_IXSCAN",
+        "EXPRESS_UPDATE",
+        "EXPRESS_DELETE",
+        "IDHACK",
+    ];
+    if (stage && indexScanStages.includes(stage)) {
+        return true;
+    }
+    if (inputStage && inputStage.stage && indexScanStages.includes(inputStage.stage)) {
+        return true;
+    }
+    // Recursively check deeper stages
+    if (inputStage && inputStage.inputStage) {
+        return usesIndex({ queryPlanner: { winningPlan: inputStage } });
+    }
+    if (stage === "COLLSCAN") {
+        return false;
+    }
+    // Default to false (conservative approach)
+    return false;
+}
+/**
+ * Generate an error message for index check failure
+ */
+export function getIndexCheckErrorMessage(database, collection, operation) {
+    return `Index check failed: The ${operation} operation on "${database}.${collection}" performs a collection scan (COLLSCAN) instead of using an index. Consider adding an index for better performance. Use 'explain' tool for query plan analysis or 'collection-indexes' to view existing indexes. To disable this check, set MDB_MCP_INDEX_CHECK to false.`;
+}
+/**
+ * Generic function to perform index usage check
+ */
+export async function checkIndexUsage(provider, database, collection, operation, explainCallback) {
+    try {
+        const explainResult = await explainCallback();
+        if (!usesIndex(explainResult)) {
+            throw new MongoDBError(ErrorCodes.ForbiddenCollscan, getIndexCheckErrorMessage(database, collection, operation));
+        }
+    }
+    catch (error) {
+        if (error instanceof MongoDBError && error.code === ErrorCodes.ForbiddenCollscan) {
+            throw error;
+        }
+        // If explain itself fails, log but do not prevent query execution
+        // This avoids blocking normal queries in special cases (e.g., permission issues)
+        console.warn(`Index check failed to execute explain for ${operation} on ${database}.${collection}:`, error);
+    }
+}
+//# sourceMappingURL=indexCheck.js.map

package/dist/esm/helpers/indexCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexCheck.js","sourceRoot":"","sources":["../../../src/helpers/indexCheck.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,aAAuB;IAC7C,MAAM,YAAY,GAAG,aAAa,EAAE,YAAoC,CAAC;IACzE,MAAM,WAAW,GAAG,YAAY,EAAE,WAAmC,CAAC;IACtE,MAAM,KAAK,GAAG,WAAW,EAAE,KAA2B,CAAC;IACvD,MAAM,UAAU,GAAG,WAAW,EAAE,UAAkC,CAAC;IAEnE,8DAA8D;IAC9D,MAAM,eAAe,GAAG;QACpB,QAAQ;QACR,YAAY;QACZ,gBAAgB;QAChB,0BAA0B;QAC1B,gBAAgB;QAChB,gBAAgB;QAChB,QAAQ;KACX,CAAC;IAEF,IAAI,KAAK,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,UAAU,IAAI,UAAU,CAAC,KAAK,IAAI,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAe,CAAC,EAAE,CAAC;QACzF,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kCAAkC;IAClC,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,2CAA2C;IAC3C,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,UAAkB,EAAE,SAAiB;IAC7F,OAAO,2BAA2B,SAAS,kBAAkB,QAAQ,IAAI,UAAU,2QAA2Q,CAAC;AACnW,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,QAAmC,EACnC,QAAgB,EAChB,UAAkB,EAClB,SAAiB,EACjB,eAAwC;IAExC,IAAI,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,eAAe,EAAE,CAAC;QAE9C,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,YAAY,CAClB,UAAU,CAAC,iBAAiB,EAC5B,yBAAyB,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAC7D,CAAC;QACN,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,iBAAiB,EAAE,CAAC;YAC/E,MAAM,KAAK,CAAC;QAChB,CAAC;QAED,kEAAkE;QAClE,iFAAiF;QACjF,OAAO,CAAC,IAAI,CAAC,6CAA6C,SAAS,OAAO,QAAQ,IAAI,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;IAChH,CAAC;AACL,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+function enableFipsIfRequested() {
+    let fipsError;
+    const tlsFIPSMode = process.argv.includes("--tlsFIPSMode");
+    if (tlsFIPSMode) {
+        try {
+            // eslint-disable-next-line
+            require("crypto").setFips(1);
+        }
+        catch (err) {
+            fipsError ?? (fipsError = err);
+        }
+    }
+    if (tlsFIPSMode) {
+        if (!fipsError && !crypto.getFips()) {
+            fipsError = new Error("FIPS mode not enabled despite requested due to unknown error.");
+        }
+    }
+    if (fipsError) {
+        if (process.config.variables.node_shared_openssl) {
+            console.error("Could not enable FIPS mode. Please ensure that your system OpenSSL installation supports FIPS.");
+        }
+        else {
+            console.error("Could not enable FIPS mode. This installation does not appear to support FIPS.");
+        }
+        console.error("Error details:");
+        console.error(fipsError);
+        process.exit(1);
+    }
+}
+enableFipsIfRequested();
+import { ConsoleLogger, LogId } from "./common/logger.js";
+import { config } from "./common/config.js";
+import crypto from "crypto";
+import { packageInfo } from "./common/packageInfo.js";
+import { StdioRunner } from "./transports/stdio.js";
+import { StreamableHttpRunner } from "./transports/streamableHttp.js";
+import { systemCA } from "@mongodb-js/devtools-proxy-support";
+async function main() {
+    systemCA().catch(() => undefined); // load system CA asynchronously as in mongosh
+    assertHelpMode();
+    assertVersionMode();
+    const transportRunner = config.transport === "stdio" ? new StdioRunner(config) : new StreamableHttpRunner(config);
+    const shutdown = () => {
+        transportRunner.logger.info({
+            id: LogId.serverCloseRequested,
+            context: "server",
+            message: `Server close requested`,
+        });
+        transportRunner
+            .close()
+            .then(() => {
+            transportRunner.logger.info({
+                id: LogId.serverClosed,
+                context: "server",
+                message: `Server closed`,
+            });
+            process.exit(0);
+        })
+            .catch((error) => {
+            transportRunner.logger.error({
+                id: LogId.serverCloseFailure,
+                context: "server",
+                message: `Error closing server: ${error}`,
+            });
+            process.exit(1);
+        });
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGABRT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.on("SIGQUIT", shutdown);
+    try {
+        await transportRunner.start();
+    }
+    catch (error) {
+        transportRunner.logger.info({
+            id: LogId.serverCloseRequested,
+            context: "server",
+            message: `Closing server due to error: ${error}`,
+            noRedaction: true,
+        });
+        try {
+            await transportRunner.close();
+            transportRunner.logger.info({
+                id: LogId.serverClosed,
+                context: "server",
+                message: "Server closed",
+            });
+        }
+        catch (error) {
+            transportRunner.logger.error({
+                id: LogId.serverCloseFailure,
+                context: "server",
+                message: `Error closing server: ${error}`,
+            });
+        }
+        throw error;
+    }
+}
+main().catch((error) => {
+    // At this point, we may be in a very broken state, so we can't rely on the logger
+    // being functional. Instead, create a brand new ConsoleLogger and log the error
+    // to the console.
+    const logger = new ConsoleLogger();
+    logger.emergency({
+        id: LogId.serverStartFailure,
+        context: "server",
+        message: `Fatal error running server: ${error}`,
+    });
+    process.exit(1);
+});
+function assertHelpMode() {
+    if (config.help) {
+        console.log("For usage information refer to the README.md:");
+        console.log("https://github.com/mongodb-js/mongodb-mcp-server?tab=readme-ov-file#quick-start");
+        process.exit(0);
+    }
+}
+function assertVersionMode() {
+    if (config.version) {
+        console.log(packageInfo.version);
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/lib.d.ts

@@ -0,0 +1,9 @@
+export { Server, type ServerOptions } from "./server.js";
+export { Session, type SessionOptions } from "./common/session.js";
+export { defaultUserConfig, type UserConfig } from "./common/config.js";
+export { LoggerBase, type LogPayload, type LoggerType, type LogLevel } from "./common/logger.js";
+export { StreamableHttpRunner } from "./transports/streamableHttp.js";
+export { ConnectionManager, type AnyConnectionState, type ConnectionState, type ConnectionStateDisconnected, type ConnectionStateErrored, type ConnectionManagerFactoryFn, } from "./common/connectionManager.js";
+export { Telemetry } from "./telemetry/telemetry.js";
+export { packageInfo } from "./common/packageInfo.js";
+//# sourceMappingURL=lib.d.ts.map

package/dist/esm/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACH,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,GAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/lib.js

@@ -0,0 +1,9 @@
+export { Server } from "./server.js";
+export { Session } from "./common/session.js";
+export { defaultUserConfig } from "./common/config.js";
+export { LoggerBase } from "./common/logger.js";
+export { StreamableHttpRunner } from "./transports/streamableHttp.js";
+export { ConnectionManager, } from "./common/connectionManager.js";
+export { Telemetry } from "./telemetry/telemetry.js";
+export { packageInfo } from "./common/packageInfo.js";
+//# sourceMappingURL=lib.js.map

package/dist/esm/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAuB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAmB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAmD,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACH,iBAAiB,GAMpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/esm/resources/common/config.d.ts

@@ -0,0 +1,10 @@
+import { ReactiveResource } from "../resource.js";
+import type { UserConfig } from "../../common/config.js";
+import type { Telemetry } from "../../telemetry/telemetry.js";
+import type { Session } from "../../lib.js";
+export declare class ConfigResource extends ReactiveResource<UserConfig, readonly []> {
+    constructor(session: Session, config: UserConfig, telemetry: Telemetry);
+    reduce(eventName: undefined, event: undefined): UserConfig;
+    toOutput(): string;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/esm/resources/common/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/resources/common/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC;gBAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS;IAmBtE,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU;IAO1D,QAAQ,IAAI,MAAM;CAgBrB"}

package/dist/esm/resources/common/config.js

@@ -0,0 +1,42 @@
+import { ReactiveResource } from "../resource.js";
+import { defaultDriverOptions } from "../../common/config.js";
+export class ConfigResource extends ReactiveResource {
+    constructor(session, config, telemetry) {
+        super({
+            resourceConfiguration: {
+                name: "config",
+                uri: "config://config",
+                config: {
+                    description: "Server configuration, supplied by the user either as environment variables or as startup arguments",
+                },
+            },
+            options: {
+                initial: { ...config },
+                events: [],
+            },
+            session,
+            config,
+            telemetry,
+        });
+    }
+    reduce(eventName, event) {
+        void eventName;
+        void event;
+        return this.current;
+    }
+    toOutput() {
+        const result = {
+            telemetry: this.current.telemetry,
+            logPath: this.current.logPath,
+            connectionString: this.current.connectionString
+                ? "set; access to MongoDB tools are currently available to use"
+                : "not set; before using any MongoDB tool, you need to configure a connection string, alternatively you can setup MongoDB Atlas access, more info at 'https://github.com/mongodb-js/mongodb-mcp-server'.",
+            connectOptions: defaultDriverOptions,
+            atlas: this.current.apiClientId && this.current.apiClientSecret
+                ? "set; MongoDB Atlas tools are currently available to use"
+                : "not set; MongoDB Atlas tools are currently unavailable, to have access to MongoDB Atlas tools like creating clusters or connecting to clusters make sure to setup credentials, more info at 'https://github.com/mongodb-js/mongodb-mcp-server'.",
+        };
+        return JSON.stringify(result);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/esm/resources/common/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/resources/common/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,MAAM,OAAO,cAAe,SAAQ,gBAAyC;IACzE,YAAY,OAAgB,EAAE,MAAkB,EAAE,SAAoB;QAClE,KAAK,CAAC;YACF,qBAAqB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,GAAG,EAAE,iBAAiB;gBACtB,MAAM,EAAE;oBACJ,WAAW,EACP,oGAAoG;iBAC3G;aACJ;YACD,OAAO,EAAE;gBACL,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE;gBACtB,MAAM,EAAE,EAAE;aACb;YACD,OAAO;YACP,MAAM;YACN,SAAS;SACZ,CAAC,CAAC;IACP,CAAC;IACD,MAAM,CAAC,SAAoB,EAAE,KAAgB;QACzC,KAAK,SAAS,CAAC;QACf,KAAK,KAAK,CAAC;QAEX,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,QAAQ;QACJ,MAAM,MAAM,GAAG;YACX,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB;gBAC3C,CAAC,CAAC,6DAA6D;gBAC/D,CAAC,CAAC,uMAAuM;YAC7M,cAAc,EAAE,oBAAoB;YACpC,KAAK,EACD,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe;gBACpD,CAAC,CAAC,yDAAyD;gBAC3D,CAAC,CAAC,iPAAiP;SAC9P,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACJ"}

package/dist/esm/resources/common/debug.d.ts

@@ -0,0 +1,17 @@
+import { ReactiveResource } from "../resource.js";
+import type { Telemetry } from "../../telemetry/telemetry.js";
+import type { Session, UserConfig } from "../../lib.js";
+import type { AtlasClusterConnectionInfo, ConnectionStateErrored } from "../../common/connectionManager.js";
+type ConnectionStateDebuggingInformation = {
+    readonly tag: "connected" | "connecting" | "disconnected" | "errored";
+    readonly connectionStringAuthType?: "scram" | "ldap" | "kerberos" | "oidc-auth-flow" | "oidc-device-flow" | "x.509";
+    readonly errorReason?: string;
+    readonly connectedAtlasCluster?: AtlasClusterConnectionInfo;
+};
+export declare class DebugResource extends ReactiveResource<ConnectionStateDebuggingInformation, readonly ["connect", "disconnect", "close", "connection-error"]> {
+    constructor(session: Session, config: UserConfig, telemetry: Telemetry);
+    reduce(eventName: "connect" | "disconnect" | "close" | "connection-error", event: ConnectionStateErrored | undefined): ConnectionStateDebuggingInformation;
+    toOutput(): string;
+}
+export {};
+//# sourceMappingURL=debug.d.ts.map

package/dist/esm/resources/common/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../../src/resources/common/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE5G,KAAK,mCAAmC,GAAG;IACvC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,OAAO,CAAC;IACpH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;CAC/D,CAAC;AAEF,qBAAa,aAAc,SAAQ,gBAAgB,CAC/C,mCAAmC,EACnC,SAAS,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAClE;gBACe,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS;IAmBtE,MAAM,CACF,SAAS,EAAE,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,kBAAkB,EAClE,KAAK,EAAE,sBAAsB,GAAG,SAAS,GAC1C,mCAAmC;IAoBtC,QAAQ,IAAI,MAAM;CA0BrB"}

package/dist/esm/resources/common/debug.js

@@ -0,0 +1,63 @@
+import { ReactiveResource } from "../resource.js";
+export class DebugResource extends ReactiveResource {
+    constructor(session, config, telemetry) {
+        super({
+            resourceConfiguration: {
+                name: "debug-mongodb",
+                uri: "debug://mongodb",
+                config: {
+                    description: "Debugging information for MongoDB connectivity issues. Tracks the last connectivity attempt and error information.",
+                },
+            },
+            options: {
+                initial: { tag: "disconnected" },
+                events: ["connect", "disconnect", "close", "connection-error"],
+            },
+            session,
+            config,
+            telemetry,
+        });
+    }
+    reduce(eventName, event) {
+        switch (eventName) {
+            case "connect":
+                return { tag: "connected" };
+            case "connection-error": {
+                return {
+                    tag: "errored",
+                    connectionStringAuthType: event?.connectionStringAuthType,
+                    connectedAtlasCluster: event?.connectedAtlasCluster,
+                    errorReason: event?.errorReason ??
+                        "Could not find a reason. This might be a bug in the MCP Server. Please open an issue in https://github.com/mongodb-js/mongodb-mcp-server.",
+                };
+            }
+            case "disconnect":
+            case "close":
+                return { tag: "disconnected" };
+        }
+    }
+    toOutput() {
+        let result = "";
+        switch (this.current.tag) {
+            case "connected":
+                result += "The user is connected to the MongoDB cluster.";
+                break;
+            case "errored":
+                result += `The user is not connected to a MongoDB cluster because of an error.\n`;
+                if (this.current.connectedAtlasCluster) {
+                    result += `Attempted connecting to Atlas Cluster "${this.current.connectedAtlasCluster.clusterName}" in project with id "${this.current.connectedAtlasCluster.projectId}".\n`;
+                }
+                if (this.current.connectionStringAuthType !== undefined) {
+                    result += `The inferred authentication mechanism is "${this.current.connectionStringAuthType}".\n`;
+                }
+                result += `<error>${this.current.errorReason}</error>`;
+                break;
+            case "connecting":
+            case "disconnected":
+                result += "The user is not connected to a MongoDB cluster.";
+                break;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/esm/resources/common/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../../src/resources/common/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAYlD,MAAM,OAAO,aAAc,SAAQ,gBAGlC;IACG,YAAY,OAAgB,EAAE,MAAkB,EAAE,SAAoB;QAClE,KAAK,CAAC;YACF,qBAAqB,EAAE;gBACnB,IAAI,EAAE,eAAe;gBACrB,GAAG,EAAE,iBAAiB;gBACtB,MAAM,EAAE;oBACJ,WAAW,EACP,oHAAoH;iBAC3H;aACJ;YACD,OAAO,EAAE;gBACL,OAAO,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE;gBAChC,MAAM,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,CAAC;aACjE;YACD,OAAO;YACP,MAAM;YACN,SAAS;SACZ,CAAC,CAAC;IACP,CAAC;IACD,MAAM,CACF,SAAkE,EAClE,KAAyC;QAEzC,QAAQ,SAAS,EAAE,CAAC;YAChB,KAAK,SAAS;gBACV,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;YAChC,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACtB,OAAO;oBACH,GAAG,EAAE,SAAS;oBACd,wBAAwB,EAAE,KAAK,EAAE,wBAAwB;oBACzD,qBAAqB,EAAE,KAAK,EAAE,qBAAqB;oBACnD,WAAW,EACP,KAAK,EAAE,WAAW;wBAClB,2IAA2I;iBAClJ,CAAC;YACN,CAAC;YACD,KAAK,YAAY,CAAC;YAClB,KAAK,OAAO;gBACR,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;QACvC,CAAC;IACL,CAAC;IAED,QAAQ;QACJ,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACvB,KAAK,WAAW;gBACZ,MAAM,IAAI,+CAA+C,CAAC;gBAC1D,MAAM;YACV,KAAK,SAAS;gBACV,MAAM,IAAI,uEAAuE,CAAC;gBAClF,IAAI,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;oBACrC,MAAM,IAAI,0CAA0C,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,WAAW,yBAAyB,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,SAAS,MAAM,CAAC;gBAClL,CAAC;gBAED,IAAI,IAAI,CAAC,OAAO,CAAC,wBAAwB,KAAK,SAAS,EAAE,CAAC;oBACtD,MAAM,IAAI,6CAA6C,IAAI,CAAC,OAAO,CAAC,wBAAwB,MAAM,CAAC;gBACvG,CAAC;gBACD,MAAM,IAAI,UAAU,IAAI,CAAC,OAAO,CAAC,WAAW,UAAU,CAAC;gBACvD,MAAM;YACV,KAAK,YAAY,CAAC;YAClB,KAAK,cAAc;gBACf,MAAM,IAAI,iDAAiD,CAAC;gBAC5D,MAAM;QACd,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}

package/dist/esm/resources/common/exportedData.d.ts

@@ -0,0 +1,15 @@
+import type { Server } from "../../server.js";
+import type { Session } from "../../common/session.js";
+export declare class ExportedData {
+    private readonly session;
+    private readonly name;
+    private readonly description;
+    private readonly uri;
+    private server?;
+    constructor(session: Session);
+    register(server: Server): void;
+    private listResourcesCallback;
+    private autoCompleteExportName;
+    private readResourceCallback;
+}
+//# sourceMappingURL=exportedData.d.ts.map

package/dist/esm/resources/common/exportedData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportedData.d.ts","sourceRoot":"","sources":["../../../../src/resources/common/exportedData.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,qBAAa,YAAY;IAMT,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkC;IACtD,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEK,OAAO,EAAE,OAAO;IAEtC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA6BrC,OAAO,CAAC,qBAAqB,CAsB3B;IAEF,OAAO,CAAC,sBAAsB,CAa5B;IAEF,OAAO,CAAC,oBAAoB,CA4B1B;CACL"}

package/dist/esm/resources/common/exportedData.js

@@ -0,0 +1,99 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LogId } from "../../common/logger.js";
+export class ExportedData {
+    constructor(session) {
+        this.session = session;
+        this.name = "exported-data";
+        this.description = "Data files exported in the current session.";
+        this.uri = "exported-data://{exportName}";
+        this.listResourcesCallback = () => {
+            try {
+                return {
+                    resources: this.session.exportsManager.availableExports.map(({ exportName, exportTitle, exportURI }) => ({
+                        name: exportName,
+                        description: exportTitle,
+                        uri: exportURI,
+                        mimeType: "application/json",
+                    })),
+                };
+            }
+            catch (error) {
+                this.session.logger.error({
+                    id: LogId.exportedDataListError,
+                    context: "Error when listing exported data resources",
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                return {
+                    resources: [],
+                };
+            }
+        };
+        this.autoCompleteExportName = (value) => {
+            try {
+                return this.session.exportsManager.availableExports
+                    .filter(({ exportName }) => exportName.startsWith(value))
+                    .map(({ exportName }) => exportName);
+            }
+            catch (error) {
+                this.session.logger.error({
+                    id: LogId.exportedDataAutoCompleteError,
+                    context: "Error when autocompleting exported data",
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                return [];
+            }
+        };
+        this.readResourceCallback = async (url, { exportName }) => {
+            try {
+                if (typeof exportName !== "string") {
+                    throw new Error("Cannot retrieve exported data, exportName not provided.");
+                }
+                const content = await this.session.exportsManager.readExport(exportName);
+                return {
+                    contents: [
+                        {
+                            uri: url.href,
+                            text: content,
+                            mimeType: "application/json",
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    contents: [
+                        {
+                            uri: url.href,
+                            text: `Error reading ${url.href}: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        };
+    }
+    register(server) {
+        this.server = server;
+        this.server.mcpServer.registerResource(this.name, new ResourceTemplate(this.uri, {
+            /**
+             * A few clients have the capability of listing templated
+             * resources as well and this callback provides support for that
+             * */
+            list: this.listResourcesCallback,
+            /**
+             * This is to provide auto completion when user starts typing in
+             * value for template variable, in our case, exportName */
+            complete: {
+                exportName: this.autoCompleteExportName,
+            },
+        }), { description: this.description }, this.readResourceCallback);
+        this.session.exportsManager.on("export-available", (uri) => {
+            server.sendResourceListChanged();
+            server.sendResourceUpdated(uri);
+        });
+        this.session.exportsManager.on("export-expired", () => {
+            server.sendResourceListChanged();
+        });
+    }
+}
+//# sourceMappingURL=exportedData.js.map

package/dist/esm/resources/common/exportedData.js.map

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

package/dist/esm/resources/resource.d.ts

@@ -0,0 +1,44 @@
+import type { Server } from "../server.js";
+import type { Session } from "../common/session.js";
+import type { UserConfig } from "../common/config.js";
+import type { Telemetry } from "../telemetry/telemetry.js";
+import type { SessionEvents } from "../common/session.js";
+import type { ResourceMetadata } from "@modelcontextprotocol/sdk/server/mcp.js";
+type PayloadOf<K extends keyof SessionEvents> = SessionEvents[K][0];
+export type ResourceConfiguration = {
+    name: string;
+    uri: string;
+    config: ResourceMetadata;
+};
+export type ReactiveResourceOptions<Value, RelevantEvents extends readonly (keyof SessionEvents)[]> = {
+    initial: Value;
+    events: RelevantEvents;
+};
+export declare abstract class ReactiveResource<Value, RelevantEvents extends readonly (keyof SessionEvents)[]> {
+    protected server?: Server;
+    protected session: Session;
+    protected config: UserConfig;
+    protected telemetry: Telemetry;
+    protected current: Value;
+    protected readonly name: string;
+    protected readonly uri: string;
+    protected readonly resourceConfig: ResourceMetadata;
+    protected readonly events: RelevantEvents;
+    constructor({ resourceConfiguration, options, session, config, telemetry, current, }: {
+        resourceConfiguration: ResourceConfiguration;
+        options: ReactiveResourceOptions<Value, RelevantEvents>;
+        session: Session;
+        config: UserConfig;
+        telemetry: Telemetry;
+        current?: Value;
+    });
+    private setupEventListeners;
+    register(server: Server): void;
+    private resourceCallback;
+    private triggerUpdate;
+    reduceApply(eventName: RelevantEvents[number], ...event: PayloadOf<RelevantEvents[number]>[]): void;
+    protected abstract reduce(eventName: RelevantEvents[number], ...event: PayloadOf<RelevantEvents[number]>[]): Value;
+    abstract toOutput(): string;
+}
+export {};
+//# sourceMappingURL=resource.d.ts.map

package/dist/esm/resources/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/resources/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAGtG,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,qBAAqB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,KAAK,EAAE,cAAc,SAAS,SAAS,CAAC,MAAM,aAAa,CAAC,EAAE,IAAI;IAClG,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,8BAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,SAAS,SAAS,CAAC,MAAM,aAAa,CAAC,EAAE;IACjG,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC;IAC7B,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;IAE/B,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC;IACzB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAE9B,EACR,qBAAqB,EACrB,OAAO,EACP,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,GACV,EAAE;QACC,qBAAqB,EAAE,qBAAqB,CAAC;QAC7C,OAAO,EAAE,uBAAuB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,UAAU,CAAC;QACnB,SAAS,EAAE,SAAS,CAAC;QACrB,OAAO,CAAC,EAAE,KAAK,CAAC;KACnB;IAcD,OAAO,CAAC,mBAAmB;IASpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKrC,OAAO,CAAC,gBAAgB,CAQrB;IAEH,OAAO,CAAC,aAAa;IAad,WAAW,CAAC,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI;IAI1G,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,KAAK;aAClG,QAAQ,IAAI,MAAM;CACrC"}

package/dist/esm/resources/resource.js

@@ -0,0 +1,52 @@
+import { LogId } from "../common/logger.js";
+export class ReactiveResource {
+    constructor({ resourceConfiguration, options, session, config, telemetry, current, }) {
+        this.resourceCallback = (uri) => ({
+            contents: [
+                {
+                    text: this.toOutput(),
+                    mimeType: "application/json",
+                    uri: uri.href,
+                },
+            ],
+        });
+        this.session = session;
+        this.config = config;
+        this.telemetry = telemetry;
+        this.name = resourceConfiguration.name;
+        this.uri = resourceConfiguration.uri;
+        this.resourceConfig = resourceConfiguration.config;
+        this.events = options.events;
+        this.current = current ?? options.initial;
+        this.setupEventListeners();
+    }
+    setupEventListeners() {
+        for (const event of this.events) {
+            this.session.on(event, (...args) => {
+                this.reduceApply(event, args[0]);
+                void this.triggerUpdate();
+            });
+        }
+    }
+    register(server) {
+        this.server = server;
+        this.server.mcpServer.registerResource(this.name, this.uri, this.resourceConfig, this.resourceCallback);
+    }
+    triggerUpdate() {
+        try {
+            this.server?.sendResourceListChanged();
+            this.server?.sendResourceUpdated(this.uri);
+        }
+        catch (error) {
+            this.session.logger.warning({
+                id: LogId.resourceUpdateFailure,
+                context: "resource",
+                message: `Could not send the latest resources to the client: ${error}`,
+            });
+        }
+    }
+    reduceApply(eventName, ...event) {
+        this.current = this.reduce(eventName, ...event);
+    }
+}
+//# sourceMappingURL=resource.js.map

package/dist/esm/resources/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../src/resources/resource.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAe5C,MAAM,OAAgB,gBAAgB;IAYlC,YAAY,EACR,qBAAqB,EACrB,OAAO,EACP,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,GAQV;QA4BO,qBAAgB,GAAyB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACvD,QAAQ,EAAE;gBACN;oBACI,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;oBACrB,QAAQ,EAAE,kBAAkB;oBAC5B,GAAG,EAAE,GAAG,CAAC,IAAI;iBAChB;aACJ;SACJ,CAAC,CAAC;QAnCC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;QACvC,IAAI,CAAC,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,qBAAqB,CAAC,MAAM,CAAC;QACnD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;QAE1C,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC/B,CAAC;IAEO,mBAAmB;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAiC,EAAE,EAAE;gBAC5D,IAAI,CAAC,WAAW,CAAC,KAAK,EAAG,IAAkB,CAAC,CAAC,CAA4B,CAAC,CAAC;gBAC3E,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9B,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5G,CAAC;IAYO,aAAa;QACjB,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;gBACxB,EAAE,EAAE,KAAK,CAAC,qBAAqB;gBAC/B,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,sDAAsD,KAAe,EAAE;aACnF,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAEM,WAAW,CAAC,SAAiC,EAAE,GAAG,KAA0C;QAC/F,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC;IACpD,CAAC;CAIJ"}