mongodb-mcp-server 0.2.0 → 0.3.1-prerelease.1

package/dist/cjs/telemetry/types.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Result type constants for telemetry events
+ */
+export type TelemetryResult = "success" | "failure";
+export type ServerCommand = "start" | "stop";
+export type TelemetryBoolSet = "true" | "false";
+/**
+ * Base interface for all events
+ */
+export type TelemetryEvent<T> = {
+    timestamp: string;
+    source: "mdbmcp";
+    properties: T & {
+        component: string;
+        duration_ms: number;
+        result: TelemetryResult;
+        category: string;
+    };
+};
+export type BaseEvent = TelemetryEvent<unknown>;
+/**
+ * Interface for tool events
+ */
+export type ToolEventProperties = {
+    command: string;
+    error_code?: string;
+    error_type?: string;
+    project_id?: string;
+    org_id?: string;
+    cluster_name?: string;
+    is_atlas?: boolean;
+};
+export type ToolEvent = TelemetryEvent<ToolEventProperties>;
+/**
+ * Interface for server events
+ */
+export type ServerEventProperties = {
+    command: ServerCommand;
+    reason?: string;
+    startup_time_ms?: number;
+    runtime_duration_ms?: number;
+    read_only_mode?: boolean;
+    disabled_tools?: string[];
+};
+export type ServerEvent = TelemetryEvent<ServerEventProperties>;
+/**
+ * Interface for static properties, they can be fetched once and reused.
+ */
+export type CommonStaticProperties = {
+    /**
+     * The version of the MCP server (as read from package.json).
+     */
+    mcp_server_version: string;
+    /**
+     * The name of the MCP server (as read from package.json).
+     */
+    mcp_server_name: string;
+    /**
+     * The platform/OS the MCP server is running on.
+     */
+    platform: string;
+    /**
+     * The architecture of the OS the server is running on.
+     */
+    arch: string;
+    /**
+     * Same as platform.
+     */
+    os_type: string;
+    /**
+     * The version of the OS the server is running on.
+     */
+    os_version?: string;
+};
+/**
+ * Common properties for all events that might change.
+ */
+export type CommonProperties = {
+    /**
+     * The device id - will be populated with the machine id when it resolves.
+     */
+    device_id?: string;
+    /**
+     * A boolean indicating whether the server is running in a container environment.
+     */
+    is_container_env?: boolean;
+    /**
+     * The version of the MCP client as reported by the client on session establishment.
+     */
+    mcp_client_version?: string;
+    /**
+     * The name of the MCP client as reported by the client on session establishment.
+     */
+    mcp_client_name?: string;
+    /**
+     * The transport protocol used by the MCP server.
+     */
+    transport?: "stdio" | "http";
+    /**
+     * A boolean indicating whether Atlas credentials are configured.
+     */
+    config_atlas_auth?: TelemetryBoolSet;
+    /**
+     * A boolean indicating whether a connection string is configured.
+     */
+    config_connection_string?: TelemetryBoolSet;
+    /**
+     * The randomly generated session id.
+     */
+    session_id?: string;
+    /**
+     * The way the MCP server is hosted - e.g. standalone for a server running independently or
+     * "vscode" if embedded in the VSCode extension. This field should be populated by the hosting
+     * application to differentiate events coming from an MCP server it's hosting.
+     */
+    hosting_mode?: string;
+} & CommonStaticProperties;
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/telemetry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/telemetry/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAC7C,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,CAAC,GAAG;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,eAAe,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAAC;AAC5D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC,qBAAqB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE7B;;OAEG;IACH,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IAErC;;OAEG;IACH,wBAAwB,CAAC,EAAE,gBAAgB,CAAC;IAE5C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,sBAAsB,CAAC"}

package/dist/cjs/telemetry/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/telemetry/types.js.map

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

package/dist/cjs/tools/atlas/atlasTool.d.ts

@@ -0,0 +1,18 @@
+import type { ToolCategory, TelemetryToolMetadata, ToolArgs } from "../tool.js";
+import { ToolBase } from "../tool.js";
+import type { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare abstract class AtlasToolBase extends ToolBase {
+    category: ToolCategory;
+    protected verifyAllowed(): boolean;
+    protected handleError(error: unknown, args: ToolArgs<typeof this.argsShape>): Promise<CallToolResult> | CallToolResult;
+    /**
+     *
+     * Resolves the tool metadata from the arguments passed to the tool
+     *
+     * @param args - The arguments passed to the tool
+     * @returns The tool metadata
+     */
+    protected resolveTelemetryMetadata(...args: Parameters<ToolCallback<typeof this.argsShape>>): TelemetryToolMetadata;
+}
+//# sourceMappingURL=atlasTool.d.ts.map

package/dist/cjs/tools/atlas/atlasTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlasTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/atlas/atlasTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKzE,8BAAsB,aAAc,SAAQ,QAAQ;IACzC,QAAQ,EAAE,YAAY,CAAW;IAExC,SAAS,CAAC,aAAa,IAAI,OAAO;IAOlC,SAAS,CAAC,WAAW,CACjB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GACtC,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc;IAyC3C;;;;;;OAMG;IACH,SAAS,CAAC,wBAAwB,CAC9B,GAAG,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GACzD,qBAAqB;CAgC3B"}

package/dist/cjs/tools/atlas/atlasTool.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtlasToolBase = void 0;
+const tool_js_1 = require("../tool.js");
+const logger_js_1 = require("../../common/logger.js");
+const zod_1 = require("zod");
+const apiClientError_js_1 = require("../../common/atlas/apiClientError.js");
+class AtlasToolBase extends tool_js_1.ToolBase {
+    constructor() {
+        super(...arguments);
+        this.category = "atlas";
+    }
+    verifyAllowed() {
+        if (!this.config.apiClientId || !this.config.apiClientSecret) {
+            return false;
+        }
+        return super.verifyAllowed();
+    }
+    handleError(error, args) {
+        if (error instanceof apiClientError_js_1.ApiClientError) {
+            const statusCode = error.response.status;
+            if (statusCode === 401) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Unable to authenticate with MongoDB Atlas, API error: ${error.message}
+
+Hint: Your API credentials may be invalid, expired or lack permissions.
+Please check your Atlas API credentials and ensure they have the appropriate permissions.
+For more information on setting up API keys, visit: https://www.mongodb.com/docs/atlas/configure-api-access/`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (statusCode === 403) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Received a Forbidden API Error: ${error.message}
+
+You don't have sufficient permissions to perform this action in MongoDB Atlas
+Please ensure your API key has the necessary roles assigned.
+For more information on Atlas API access roles, visit: https://www.mongodb.com/docs/atlas/api/service-accounts-overview/`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        // For other types of errors, use the default error handling from the base class
+        return super.handleError(error, args);
+    }
+    /**
+     *
+     * Resolves the tool metadata from the arguments passed to the tool
+     *
+     * @param args - The arguments passed to the tool
+     * @returns The tool metadata
+     */
+    resolveTelemetryMetadata(...args) {
+        const toolMetadata = {};
+        if (!args.length) {
+            return toolMetadata;
+        }
+        // Create a typed parser for the exact shape we expect
+        const argsShape = zod_1.z.object(this.argsShape);
+        const parsedResult = argsShape.safeParse(args[0]);
+        if (!parsedResult.success) {
+            this.session.logger.debug({
+                id: logger_js_1.LogId.telemetryMetadataError,
+                context: "tool",
+                message: `Error parsing tool arguments: ${parsedResult.error.message}`,
+            });
+            return toolMetadata;
+        }
+        const data = parsedResult.data;
+        // Extract projectId using type guard
+        if ("projectId" in data && typeof data.projectId === "string" && data.projectId.trim() !== "") {
+            toolMetadata.projectId = data.projectId;
+        }
+        // Extract orgId using type guard
+        if ("orgId" in data && typeof data.orgId === "string" && data.orgId.trim() !== "") {
+            toolMetadata.orgId = data.orgId;
+        }
+        return toolMetadata;
+    }
+}
+exports.AtlasToolBase = AtlasToolBase;
+//# sourceMappingURL=atlasTool.js.map

package/dist/cjs/tools/atlas/atlasTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlasTool.js","sourceRoot":"","sources":["../../../../src/tools/atlas/atlasTool.ts"],"names":[],"mappings":";;;AACA,wCAAsC;AAGtC,sDAA+C;AAC/C,6BAAwB;AACxB,4EAAsE;AAEtE,MAAsB,aAAc,SAAQ,kBAAQ;IAApD;;QACW,aAAQ,GAAiB,OAAO,CAAC;IA8F5C,CAAC;IA5Fa,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC;IACjC,CAAC;IAES,WAAW,CACjB,KAAc,EACd,IAAqC;QAErC,IAAI,KAAK,YAAY,kCAAc,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAEzC,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACrB,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,yDAAyD,KAAK,CAAC,OAAO;;;;6GAIK;yBACpF;qBACJ;oBACD,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;YAED,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACrB,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mCAAmC,KAAK,CAAC,OAAO;;;;yHAIuC;yBAChG;qBACJ;oBACD,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;QACL,CAAC;QAED,gFAAgF;QAChF,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACO,wBAAwB,CAC9B,GAAG,IAAqD;QAExD,MAAM,YAAY,GAA0B,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,OAAO,YAAY,CAAC;QACxB,CAAC;QAED,sDAAsD;QACtD,MAAM,SAAS,GAAG,OAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAElD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;gBACtB,EAAE,EAAE,iBAAK,CAAC,sBAAsB;gBAChC,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,iCAAiC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE;aACzE,CAAC,CAAC;YACH,OAAO,YAAY,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;QAE/B,qCAAqC;QACrC,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5F,YAAY,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC5C,CAAC;QAED,iCAAiC;QACjC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAChF,YAAY,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACpC,CAAC;QACD,OAAO,YAAY,CAAC;IACxB,CAAC;CACJ;AA/FD,sCA+FC"}

package/dist/cjs/tools/atlas/connect/connectCluster.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { AtlasToolBase } from "../atlasTool.js";
+import type { ToolArgs, OperationType } from "../../tool.js";
+export declare class ConnectClusterTool extends AtlasToolBase {
+    name: string;
+    protected description: string;
+    operationType: OperationType;
+    protected argsShape: {
+        projectId: z.ZodString;
+        clusterName: z.ZodString;
+    };
+    private queryConnection;
+    private prepareClusterConnection;
+    private connectToCluster;
+    protected execute({ projectId, clusterName }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
+}
+//# sourceMappingURL=connectCluster.d.ts.map

package/dist/cjs/tools/atlas/connect/connectCluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectCluster.d.ts","sourceRoot":"","sources":["../../../../../src/tools/atlas/connect/connectCluster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAmB7D,qBAAa,kBAAmB,SAAQ,aAAa;IAC1C,IAAI,SAA2B;IACtC,SAAS,CAAC,WAAW,SAAsC;IACpD,aAAa,EAAE,aAAa,CAAa;IAChD,SAAS,CAAC,SAAS;;;MAGjB;IAEF,OAAO,CAAC,eAAe;YAmCT,wBAAwB;YAyDxB,gBAAgB;cA4Ed,OAAO,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CAqFhH"}

package/dist/cjs/tools/atlas/connect/connectCluster.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectClusterTool = void 0;
+const zod_1 = require("zod");
+const atlasTool_js_1 = require("../atlasTool.js");
+const generatePassword_js_1 = require("../../../helpers/generatePassword.js");
+const logger_js_1 = require("../../../common/logger.js");
+const cluster_js_1 = require("../../../common/atlas/cluster.js");
+const accessListUtils_js_1 = require("../../../common/atlas/accessListUtils.js");
+const roles_js_1 = require("../../../common/atlas/roles.js");
+const EXPIRY_MS = 1000 * 60 * 60 * 12; // 12 hours
+const addedIpAccessListMessage = "Note: Your current IP address has been added to the Atlas project's IP access list to enable secure connection.";
+const createdUserMessage = "Note: A temporary user has been created to enable secure connection to the cluster. For more information, see https://dochub.mongodb.org/core/mongodb-mcp-server-tools-considerations\n\nNote to LLM Agent: it is important to include the following link in your response to the user in case they want to get more information about the temporary user created: https://dochub.mongodb.org/core/mongodb-mcp-server-tools-considerations";
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+class ConnectClusterTool extends atlasTool_js_1.AtlasToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "atlas-connect-cluster";
+        this.description = "Connect to MongoDB Atlas cluster";
+        this.operationType = "connect";
+        this.argsShape = {
+            projectId: zod_1.z.string().describe("Atlas project ID"),
+            clusterName: zod_1.z.string().describe("Atlas cluster name"),
+        };
+    }
+    queryConnection(projectId, clusterName) {
+        if (!this.session.connectedAtlasCluster) {
+            if (this.session.isConnectedToMongoDB) {
+                return "connected-to-other-cluster";
+            }
+            return "disconnected";
+        }
+        const currentConectionState = this.session.connectionManager.currentConnectionState;
+        if (this.session.connectedAtlasCluster.projectId !== projectId ||
+            this.session.connectedAtlasCluster.clusterName !== clusterName) {
+            return "connected-to-other-cluster";
+        }
+        switch (currentConectionState.tag) {
+            case "connecting":
+            case "disconnected": // we might still be calling Atlas APIs and not attempted yet to connect to MongoDB, but we are still "connecting"
+                return "connecting";
+            case "connected":
+                return "connected";
+            case "errored":
+                this.session.logger.debug({
+                    id: logger_js_1.LogId.atlasConnectFailure,
+                    context: "atlas-connect-cluster",
+                    message: `error querying cluster: ${currentConectionState.errorReason}`,
+                });
+                return "unknown";
+        }
+    }
+    async prepareClusterConnection(projectId, clusterName) {
+        const cluster = await (0, cluster_js_1.inspectCluster)(this.session.apiClient, projectId, clusterName);
+        if (!cluster.connectionString) {
+            throw new Error("Connection string not available");
+        }
+        const username = `mcpUser${Math.floor(Math.random() * 100000)}`;
+        const password = await (0, generatePassword_js_1.generateSecurePassword)();
+        const expiryDate = new Date(Date.now() + EXPIRY_MS);
+        const role = (0, roles_js_1.getDefaultRoleFromConfig)(this.config);
+        await this.session.apiClient.createDatabaseUser({
+            params: {
+                path: {
+                    groupId: projectId,
+                },
+            },
+            body: {
+                databaseName: "admin",
+                groupId: projectId,
+                roles: [role],
+                scopes: [{ type: "CLUSTER", name: clusterName }],
+                username,
+                password,
+                awsIAMType: "NONE",
+                ldapAuthType: "NONE",
+                oidcAuthType: "NONE",
+                x509Type: "NONE",
+                deleteAfterDate: expiryDate.toISOString(),
+                description: "MDB MCP Temporary user, see https://dochub.mongodb.org/core/mongodb-mcp-server-tools-considerations",
+            },
+        });
+        const connectedAtlasCluster = {
+            username,
+            projectId,
+            clusterName,
+            expiryDate,
+        };
+        const cn = new URL(cluster.connectionString);
+        cn.username = username;
+        cn.password = password;
+        cn.searchParams.set("authSource", "admin");
+        this.session.keychain.register(username, "user");
+        this.session.keychain.register(password, "password");
+        return { connectionString: cn.toString(), atlas: connectedAtlasCluster };
+    }
+    async connectToCluster(connectionString, atlas) {
+        let lastError = undefined;
+        this.session.logger.debug({
+            id: logger_js_1.LogId.atlasConnectAttempt,
+            context: "atlas-connect-cluster",
+            message: `attempting to connect to cluster: ${this.session.connectedAtlasCluster?.clusterName}`,
+            noRedaction: true,
+        });
+        // try to connect for about 5 minutes
+        for (let i = 0; i < 600; i++) {
+            try {
+                lastError = undefined;
+                await this.session.connectToMongoDB({ connectionString, atlas });
+                break;
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                lastError = error;
+                this.session.logger.debug({
+                    id: logger_js_1.LogId.atlasConnectFailure,
+                    context: "atlas-connect-cluster",
+                    message: `error connecting to cluster: ${error.message}`,
+                });
+                await sleep(500); // wait for 500ms before retrying
+            }
+            if (!this.session.connectedAtlasCluster ||
+                this.session.connectedAtlasCluster.projectId !== atlas.projectId ||
+                this.session.connectedAtlasCluster.clusterName !== atlas.clusterName) {
+                throw new Error("Cluster connection aborted");
+            }
+        }
+        if (lastError) {
+            if (this.session.connectedAtlasCluster?.projectId === atlas.projectId &&
+                this.session.connectedAtlasCluster?.clusterName === atlas.clusterName &&
+                this.session.connectedAtlasCluster?.username) {
+                void this.session.apiClient
+                    .deleteDatabaseUser({
+                    params: {
+                        path: {
+                            groupId: this.session.connectedAtlasCluster.projectId,
+                            username: this.session.connectedAtlasCluster.username,
+                            databaseName: "admin",
+                        },
+                    },
+                })
+                    .catch((err) => {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    this.session.logger.debug({
+                        id: logger_js_1.LogId.atlasConnectFailure,
+                        context: "atlas-connect-cluster",
+                        message: `error deleting database user: ${error.message}`,
+                    });
+                });
+            }
+            throw lastError;
+        }
+        this.session.logger.debug({
+            id: logger_js_1.LogId.atlasConnectSucceeded,
+            context: "atlas-connect-cluster",
+            message: `connected to cluster: ${this.session.connectedAtlasCluster?.clusterName}`,
+            noRedaction: true,
+        });
+    }
+    async execute({ projectId, clusterName }) {
+        const ipAccessListUpdated = await (0, accessListUtils_js_1.ensureCurrentIpInAccessList)(this.session.apiClient, projectId);
+        let createdUser = false;
+        for (let i = 0; i < 60; i++) {
+            const state = this.queryConnection(projectId, clusterName);
+            switch (state) {
+                case "connected": {
+                    const content = [
+                        {
+                            type: "text",
+                            text: `Connected to cluster "${clusterName}".`,
+                        },
+                    ];
+                    if (ipAccessListUpdated) {
+                        content.push({
+                            type: "text",
+                            text: addedIpAccessListMessage,
+                        });
+                    }
+                    if (createdUser) {
+                        content.push({
+                            type: "text",
+                            text: createdUserMessage,
+                        });
+                    }
+                    return { content };
+                }
+                case "connecting":
+                case "unknown": {
+                    break;
+                }
+                case "connected-to-other-cluster":
+                case "disconnected":
+                default: {
+                    await this.session.disconnect();
+                    const { connectionString, atlas } = await this.prepareClusterConnection(projectId, clusterName);
+                    createdUser = true;
+                    // try to connect for about 5 minutes asynchronously
+                    void this.connectToCluster(connectionString, atlas).catch((err) => {
+                        const error = err instanceof Error ? err : new Error(String(err));
+                        this.session.logger.error({
+                            id: logger_js_1.LogId.atlasConnectFailure,
+                            context: "atlas-connect-cluster",
+                            message: `error connecting to cluster: ${error.message}`,
+                        });
+                    });
+                    break;
+                }
+            }
+            await sleep(500);
+        }
+        const content = [
+            {
+                type: "text",
+                text: `Attempting to connect to cluster "${clusterName}"...`,
+            },
+            {
+                type: "text",
+                text: `Warning: Provisioning a user and connecting to the cluster may take more time, please check again in a few seconds.`,
+            },
+        ];
+        if (ipAccessListUpdated) {
+            content.push({
+                type: "text",
+                text: addedIpAccessListMessage,
+            });
+        }
+        if (createdUser) {
+            content.push({
+                type: "text",
+                text: createdUserMessage,
+            });
+        }
+        return { content };
+    }
+}
+exports.ConnectClusterTool = ConnectClusterTool;
+//# sourceMappingURL=connectCluster.js.map

package/dist/cjs/tools/atlas/connect/connectCluster.js.map

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

package/dist/cjs/tools/atlas/create/createAccessList.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { AtlasToolBase } from "../atlasTool.js";
+import type { ToolArgs, OperationType } from "../../tool.js";
+export declare class CreateAccessListTool extends AtlasToolBase {
+    name: string;
+    protected description: string;
+    operationType: OperationType;
+    protected argsShape: {
+        projectId: z.ZodString;
+        ipAddresses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        cidrBlocks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        currentIpAddress: z.ZodDefault<z.ZodBoolean>;
+        comment: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    };
+    protected execute({ projectId, ipAddresses, cidrBlocks, comment, currentIpAddress, }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
+}
+//# sourceMappingURL=createAccessList.d.ts.map

package/dist/cjs/tools/atlas/create/createAccessList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAccessList.d.ts","sourceRoot":"","sources":["../../../../../src/tools/atlas/create/createAccessList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG7D,qBAAa,oBAAqB,SAAQ,aAAa;IAC5C,IAAI,SAA8B;IACzC,SAAS,CAAC,WAAW,SAAiE;IAC/E,aAAa,EAAE,aAAa,CAAY;IAC/C,SAAS,CAAC,SAAS;;;;;;MAajB;cAEc,OAAO,CAAC,EACpB,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,gBAAgB,GACnB,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CA8C/D"}

package/dist/cjs/tools/atlas/create/createAccessList.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateAccessListTool = void 0;
+const zod_1 = require("zod");
+const atlasTool_js_1 = require("../atlasTool.js");
+const accessListUtils_js_1 = require("../../../common/atlas/accessListUtils.js");
+class CreateAccessListTool extends atlasTool_js_1.AtlasToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "atlas-create-access-list";
+        this.description = "Allow Ip/CIDR ranges to access your MongoDB Atlas clusters.";
+        this.operationType = "create";
+        this.argsShape = {
+            projectId: zod_1.z.string().describe("Atlas project ID"),
+            ipAddresses: zod_1.z
+                .array(zod_1.z.string().ip({ version: "v4" }))
+                .describe("IP addresses to allow access from")
+                .optional(),
+            cidrBlocks: zod_1.z.array(zod_1.z.string().cidr()).describe("CIDR blocks to allow access from").optional(),
+            currentIpAddress: zod_1.z.boolean().describe("Add the current IP address").default(false),
+            comment: zod_1.z
+                .string()
+                .describe("Comment for the access list entries")
+                .default(accessListUtils_js_1.DEFAULT_ACCESS_LIST_COMMENT)
+                .optional(),
+        };
+    }
+    async execute({ projectId, ipAddresses, cidrBlocks, comment, currentIpAddress, }) {
+        if (!ipAddresses?.length && !cidrBlocks?.length && !currentIpAddress) {
+            throw new Error("One of  ipAddresses, cidrBlocks, currentIpAddress must be provided.");
+        }
+        const ipInputs = (ipAddresses || []).map((ipAddress) => ({
+            groupId: projectId,
+            ipAddress,
+            comment: comment || accessListUtils_js_1.DEFAULT_ACCESS_LIST_COMMENT,
+        }));
+        if (currentIpAddress) {
+            const input = await (0, accessListUtils_js_1.makeCurrentIpAccessListEntry)(this.session.apiClient, projectId, comment || accessListUtils_js_1.DEFAULT_ACCESS_LIST_COMMENT);
+            ipInputs.push(input);
+        }
+        const cidrInputs = (cidrBlocks || []).map((cidrBlock) => ({
+            groupId: projectId,
+            cidrBlock,
+            comment: comment || accessListUtils_js_1.DEFAULT_ACCESS_LIST_COMMENT,
+        }));
+        const inputs = [...ipInputs, ...cidrInputs];
+        await this.session.apiClient.createProjectIpAccessList({
+            params: {
+                path: {
+                    groupId: projectId,
+                },
+            },
+            body: inputs,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `IP/CIDR ranges added to access list for project ${projectId}.`,
+                },
+            ],
+        };
+    }
+}
+exports.CreateAccessListTool = CreateAccessListTool;
+//# sourceMappingURL=createAccessList.js.map

package/dist/cjs/tools/atlas/create/createAccessList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAccessList.js","sourceRoot":"","sources":["../../../../../src/tools/atlas/create/createAccessList.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,kDAAgD;AAEhD,iFAAqH;AAErH,MAAa,oBAAqB,SAAQ,4BAAa;IAAvD;;QACW,SAAI,GAAG,0BAA0B,CAAC;QAC/B,gBAAW,GAAG,6DAA6D,CAAC;QAC/E,kBAAa,GAAkB,QAAQ,CAAC;QACrC,cAAS,GAAG;YAClB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YAClD,WAAW,EAAE,OAAC;iBACT,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvC,QAAQ,CAAC,mCAAmC,CAAC;iBAC7C,QAAQ,EAAE;YACf,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC,QAAQ,EAAE;YAC9F,gBAAgB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YACnF,OAAO,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,qCAAqC,CAAC;iBAC/C,OAAO,CAAC,gDAA2B,CAAC;iBACpC,QAAQ,EAAE;SAClB,CAAC;IAsDN,CAAC;IApDa,KAAK,CAAC,OAAO,CAAC,EACpB,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,gBAAgB,GACc;QAC9B,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACrD,OAAO,EAAE,SAAS;YAClB,SAAS;YACT,OAAO,EAAE,OAAO,IAAI,gDAA2B;SAClD,CAAC,CAAC,CAAC;QAEJ,IAAI,gBAAgB,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,MAAM,IAAA,iDAA4B,EAC5C,IAAI,CAAC,OAAO,CAAC,SAAS,EACtB,SAAS,EACT,OAAO,IAAI,gDAA2B,CACzC,CAAC;YACF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACtD,OAAO,EAAE,SAAS;YAClB,SAAS;YACT,OAAO,EAAE,OAAO,IAAI,gDAA2B;SAClD,CAAC,CAAC,CAAC;QAEJ,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,UAAU,CAAC,CAAC;QAE5C,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,yBAAyB,CAAC;YACnD,MAAM,EAAE;gBACJ,IAAI,EAAE;oBACF,OAAO,EAAE,SAAS;iBACrB;aACJ;YACD,IAAI,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,mDAAmD,SAAS,GAAG;iBACxE;aACJ;SACJ,CAAC;IACN,CAAC;CACJ;AAvED,oDAuEC"}

package/dist/cjs/tools/atlas/create/createDBUser.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { AtlasToolBase } from "../atlasTool.js";
+import type { ToolArgs, OperationType } from "../../tool.js";
+export declare class CreateDBUserTool extends AtlasToolBase {
+    name: string;
+    protected description: string;
+    operationType: OperationType;
+    protected argsShape: {
+        projectId: z.ZodString;
+        username: z.ZodString;
+        password: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        roles: z.ZodArray<z.ZodObject<{
+            roleName: z.ZodString;
+            databaseName: z.ZodDefault<z.ZodString>;
+            collectionName: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            roleName: string;
+            databaseName: string;
+            collectionName?: string | undefined;
+        }, {
+            roleName: string;
+            databaseName?: string | undefined;
+            collectionName?: string | undefined;
+        }>, "many">;
+        clusters: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    };
+    protected execute({ projectId, username, password, roles, clusters, }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
+}
+//# sourceMappingURL=createDBUser.d.ts.map