mongodb-mcp-server 0.2.0 → 0.3.0

package/dist/cjs/tools/mongodb/read/export.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExportTool = void 0;
+const zod_1 = __importDefault(require("zod"));
+const bson_1 = require("bson");
+const mongodbTool_js_1 = require("../mongodbTool.js");
+const find_js_1 = require("./find.js");
+const exportsManager_js_1 = require("../../../common/exportsManager.js");
+const aggregate_js_1 = require("./aggregate.js");
+class ExportTool extends mongodbTool_js_1.MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "export";
+        this.description = "Export a query or aggregation results in the specified EJSON format.";
+        this.argsShape = {
+            ...mongodbTool_js_1.DbOperationArgs,
+            exportTitle: zod_1.default.string().describe("A short description to uniquely identify the export."),
+            exportTarget: zod_1.default
+                .array(zod_1.default.discriminatedUnion("name", [
+                zod_1.default.object({
+                    name: zod_1.default
+                        .literal("find")
+                        .describe("The literal name 'find' to represent a find cursor as target."),
+                    arguments: zod_1.default
+                        .object({
+                        ...find_js_1.FindArgs,
+                        limit: find_js_1.FindArgs.limit.removeDefault(),
+                    })
+                        .describe("The arguments for 'find' operation."),
+                }),
+                zod_1.default.object({
+                    name: zod_1.default
+                        .literal("aggregate")
+                        .describe("The literal name 'aggregate' to represent an aggregation cursor as target."),
+                    arguments: zod_1.default.object(aggregate_js_1.AggregateArgs).describe("The arguments for 'aggregate' operation."),
+                }),
+            ]))
+                .describe("The export target along with its arguments."),
+            jsonExportFormat: exportsManager_js_1.jsonExportFormat
+                .default("relaxed")
+                .describe([
+                "The format to be used when exporting collection data as EJSON with default being relaxed.",
+                "relaxed: A string format that emphasizes readability and interoperability at the expense of type preservation. That is, conversion from relaxed format to BSON can lose type information.",
+                "canonical: A string format that emphasizes type preservation at the expense of readability and interoperability. That is, conversion from canonical to BSON will generally preserve type information except in certain specific cases.",
+            ].join("\n")),
+        };
+        this.operationType = "read";
+    }
+    async execute({ database, collection, jsonExportFormat, exportTitle, exportTarget: target, }) {
+        const provider = await this.ensureConnected();
+        const exportTarget = target[0];
+        if (!exportTarget) {
+            throw new Error("Export target not provided. Expected one of the following: `aggregate`, `find`");
+        }
+        let cursor;
+        if (exportTarget.name === "find") {
+            const { filter, projection, sort, limit } = exportTarget.arguments;
+            cursor = provider.find(database, collection, filter ?? {}, {
+                projection,
+                sort,
+                limit,
+                promoteValues: false,
+                bsonRegExp: true,
+            });
+        }
+        else {
+            const { pipeline } = exportTarget.arguments;
+            cursor = provider.aggregate(database, collection, pipeline, {
+                promoteValues: false,
+                bsonRegExp: true,
+                allowDiskUse: true,
+            });
+        }
+        const exportName = `${database}.${collection}.${new bson_1.ObjectId().toString()}.json`;
+        const { exportURI, exportPath } = await this.session.exportsManager.createJSONExport({
+            input: cursor,
+            exportName,
+            exportTitle: exportTitle ||
+                `Export for namespace ${database}.${collection} requested on ${new Date().toLocaleString()}`,
+            jsonExportFormat,
+        });
+        const toolCallContent = [
+            // Not all the clients as of this commit understands how to
+            // parse a resource_link so we provide a text result for them to
+            // understand what to do with the result.
+            {
+                type: "text",
+                text: `Data for namespace ${database}.${collection} is being exported and will be made available under resource URI - "${exportURI}".`,
+            },
+            {
+                type: "resource_link",
+                name: exportName,
+                uri: exportURI,
+                description: "Resource URI for fetching exported data once it is ready.",
+                mimeType: "application/json",
+            },
+        ];
+        // This special case is to make it easier to work with exported data for
+        // clients that still cannot reference resources (Cursor).
+        // More information here: https://jira.mongodb.org/browse/MCP-104
+        if (this.isServerRunningLocally()) {
+            toolCallContent.push({
+                type: "text",
+                text: `Optionally, when the export is finished, the exported data can also be accessed under path - "${exportPath}"`,
+            });
+        }
+        return {
+            content: toolCallContent,
+        };
+    }
+    isServerRunningLocally() {
+        return this.config.transport === "stdio" || ["127.0.0.1", "localhost"].includes(this.config.httpHost);
+    }
+}
+exports.ExportTool = ExportTool;
+//# sourceMappingURL=export.js.map

package/dist/cjs/tools/mongodb/read/export.js.map

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

package/dist/cjs/tools/mongodb/read/find.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { MongoDBToolBase } from "../mongodbTool.js";
+import type { ToolArgs, OperationType } from "../../tool.js";
+import type { SortDirection } from "mongodb";
+export declare const FindArgs: {
+    filter: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+    projection: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    sort: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodType<SortDirection, z.ZodTypeDef, SortDirection>, {}, {}>>;
+};
+export declare class FindTool extends MongoDBToolBase {
+    name: string;
+    protected description: string;
+    protected argsShape: {
+        filter: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+        projection: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        sort: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodType<SortDirection, z.ZodTypeDef, SortDirection>, {}, {}>>;
+        database: z.ZodString;
+        collection: z.ZodString;
+    };
+    operationType: OperationType;
+    protected execute({ database, collection, filter, projection, limit, sort, }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
+}
+//# sourceMappingURL=find.d.ts.map

package/dist/cjs/tools/mongodb/read/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mongodb/read/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAmB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,eAAO,MAAM,QAAQ;;;;;CAmBpB,CAAC;AAEF,qBAAa,QAAS,SAAQ,eAAe;IAClC,IAAI,SAAU;IACrB,SAAS,CAAC,WAAW,SAAmD;IACxE,SAAS,CAAC,SAAS;;;;;;;MAGjB;IACK,aAAa,EAAE,aAAa,CAAU;cAE7B,OAAO,CAAC,EACpB,QAAQ,EACR,UAAU,EACV,MAAM,EACN,UAAU,EACV,KAAK,EACL,IAAI,GACP,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CAmB/D"}

package/dist/cjs/tools/mongodb/read/find.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FindTool = exports.FindArgs = void 0;
+const zod_1 = require("zod");
+const mongodbTool_js_1 = require("../mongodbTool.js");
+const tool_js_1 = require("../../tool.js");
+const indexCheck_js_1 = require("../../../helpers/indexCheck.js");
+const bson_1 = require("bson");
+exports.FindArgs = {
+    filter: zod_1.z
+        .object({})
+        .passthrough()
+        .optional()
+        .describe("The query filter, matching the syntax of the query argument of db.collection.find()"),
+    projection: zod_1.z
+        .object({})
+        .passthrough()
+        .optional()
+        .describe("The projection, matching the syntax of the projection argument of db.collection.find()"),
+    limit: zod_1.z.number().optional().default(10).describe("The maximum number of documents to return"),
+    sort: zod_1.z
+        .object({})
+        .catchall(zod_1.z.custom())
+        .optional()
+        .describe("A document, describing the sort order, matching the syntax of the sort argument of cursor.sort(). The keys of the object are the fields to sort on, while the values are the sort directions (1 for ascending, -1 for descending)."),
+};
+class FindTool extends mongodbTool_js_1.MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "find";
+        this.description = "Run a find query against a MongoDB collection";
+        this.argsShape = {
+            ...mongodbTool_js_1.DbOperationArgs,
+            ...exports.FindArgs,
+        };
+        this.operationType = "read";
+    }
+    async execute({ database, collection, filter, projection, limit, sort, }) {
+        const provider = await this.ensureConnected();
+        // Check if find operation uses an index if enabled
+        if (this.config.indexCheck) {
+            await (0, indexCheck_js_1.checkIndexUsage)(provider, database, collection, "find", async () => {
+                return provider.find(database, collection, filter, { projection, limit, sort }).explain("queryPlanner");
+            });
+        }
+        const documents = await provider.find(database, collection, filter, { projection, limit, sort }).toArray();
+        return {
+            content: (0, tool_js_1.formatUntrustedData)(`Found ${documents.length} documents in the collection "${collection}".`, documents.length > 0 ? bson_1.EJSON.stringify(documents) : undefined),
+        };
+    }
+}
+exports.FindTool = FindTool;
+//# sourceMappingURL=find.js.map

package/dist/cjs/tools/mongodb/read/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../../../src/tools/mongodb/read/find.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,sDAAqE;AAErE,2CAAoD;AAEpD,kEAAiE;AACjE,+BAA6B;AAEhB,QAAA,QAAQ,GAAG;IACpB,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,CAAC;SACV,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,qFAAqF,CAAC;IACpG,UAAU,EAAE,OAAC;SACR,MAAM,CAAC,EAAE,CAAC;SACV,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,wFAAwF,CAAC;IACvG,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC9F,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,CAAC;SACV,QAAQ,CAAC,OAAC,CAAC,MAAM,EAAiB,CAAC;SACnC,QAAQ,EAAE;SACV,QAAQ,CACL,oOAAoO,CACvO;CACR,CAAC;AAEF,MAAa,QAAS,SAAQ,gCAAe;IAA7C;;QACW,SAAI,GAAG,MAAM,CAAC;QACX,gBAAW,GAAG,+CAA+C,CAAC;QAC9D,cAAS,GAAG;YAClB,GAAG,gCAAe;YAClB,GAAG,gBAAQ;SACd,CAAC;QACK,kBAAa,GAAkB,MAAM,CAAC;IA4BjD,CAAC;IA1Ba,KAAK,CAAC,OAAO,CAAC,EACpB,QAAQ,EACR,UAAU,EACV,MAAM,EACN,UAAU,EACV,KAAK,EACL,IAAI,GAC0B;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAE9C,mDAAmD;QACnD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACzB,MAAM,IAAA,+BAAe,EAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;gBACrE,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC5G,CAAC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAE3G,OAAO;YACH,OAAO,EAAE,IAAA,6BAAmB,EACxB,SAAS,SAAS,CAAC,MAAM,iCAAiC,UAAU,IAAI,EACxE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAChE;SACJ,CAAC;IACN,CAAC;CACJ;AAnCD,4BAmCC"}

package/dist/cjs/tools/mongodb/tools.d.ts

@@ -0,0 +1,23 @@
+import { ConnectTool } from "./connect/connect.js";
+import { ListCollectionsTool } from "./metadata/listCollections.js";
+import { CollectionIndexesTool } from "./read/collectionIndexes.js";
+import { ListDatabasesTool } from "./metadata/listDatabases.js";
+import { CreateIndexTool } from "./create/createIndex.js";
+import { CollectionSchemaTool } from "./metadata/collectionSchema.js";
+import { FindTool } from "./read/find.js";
+import { InsertManyTool } from "./create/insertMany.js";
+import { DeleteManyTool } from "./delete/deleteMany.js";
+import { CollectionStorageSizeTool } from "./metadata/collectionStorageSize.js";
+import { CountTool } from "./read/count.js";
+import { DbStatsTool } from "./metadata/dbStats.js";
+import { AggregateTool } from "./read/aggregate.js";
+import { UpdateManyTool } from "./update/updateMany.js";
+import { RenameCollectionTool } from "./update/renameCollection.js";
+import { DropDatabaseTool } from "./delete/dropDatabase.js";
+import { DropCollectionTool } from "./delete/dropCollection.js";
+import { ExplainTool } from "./metadata/explain.js";
+import { CreateCollectionTool } from "./create/createCollection.js";
+import { LogsTool } from "./metadata/logs.js";
+import { ExportTool } from "./read/export.js";
+export declare const MongoDbTools: (typeof ConnectTool | typeof ListCollectionsTool | typeof CollectionIndexesTool | typeof ListDatabasesTool | typeof CreateIndexTool | typeof CollectionSchemaTool | typeof FindTool | typeof InsertManyTool | typeof DeleteManyTool | typeof CollectionStorageSizeTool | typeof CountTool | typeof DbStatsTool | typeof AggregateTool | typeof UpdateManyTool | typeof RenameCollectionTool | typeof DropDatabaseTool | typeof DropCollectionTool | typeof ExplainTool | typeof CreateCollectionTool | typeof LogsTool | typeof ExportTool)[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/cjs/tools/mongodb/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/tools/mongodb/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,YAAY,+gBAsBxB,CAAC"}

package/dist/cjs/tools/mongodb/tools.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoDbTools = void 0;
+const connect_js_1 = require("./connect/connect.js");
+const listCollections_js_1 = require("./metadata/listCollections.js");
+const collectionIndexes_js_1 = require("./read/collectionIndexes.js");
+const listDatabases_js_1 = require("./metadata/listDatabases.js");
+const createIndex_js_1 = require("./create/createIndex.js");
+const collectionSchema_js_1 = require("./metadata/collectionSchema.js");
+const find_js_1 = require("./read/find.js");
+const insertMany_js_1 = require("./create/insertMany.js");
+const deleteMany_js_1 = require("./delete/deleteMany.js");
+const collectionStorageSize_js_1 = require("./metadata/collectionStorageSize.js");
+const count_js_1 = require("./read/count.js");
+const dbStats_js_1 = require("./metadata/dbStats.js");
+const aggregate_js_1 = require("./read/aggregate.js");
+const updateMany_js_1 = require("./update/updateMany.js");
+const renameCollection_js_1 = require("./update/renameCollection.js");
+const dropDatabase_js_1 = require("./delete/dropDatabase.js");
+const dropCollection_js_1 = require("./delete/dropCollection.js");
+const explain_js_1 = require("./metadata/explain.js");
+const createCollection_js_1 = require("./create/createCollection.js");
+const logs_js_1 = require("./metadata/logs.js");
+const export_js_1 = require("./read/export.js");
+exports.MongoDbTools = [
+    connect_js_1.ConnectTool,
+    listCollections_js_1.ListCollectionsTool,
+    listDatabases_js_1.ListDatabasesTool,
+    collectionIndexes_js_1.CollectionIndexesTool,
+    createIndex_js_1.CreateIndexTool,
+    collectionSchema_js_1.CollectionSchemaTool,
+    find_js_1.FindTool,
+    insertMany_js_1.InsertManyTool,
+    deleteMany_js_1.DeleteManyTool,
+    collectionStorageSize_js_1.CollectionStorageSizeTool,
+    count_js_1.CountTool,
+    dbStats_js_1.DbStatsTool,
+    aggregate_js_1.AggregateTool,
+    updateMany_js_1.UpdateManyTool,
+    renameCollection_js_1.RenameCollectionTool,
+    dropDatabase_js_1.DropDatabaseTool,
+    dropCollection_js_1.DropCollectionTool,
+    explain_js_1.ExplainTool,
+    createCollection_js_1.CreateCollectionTool,
+    logs_js_1.LogsTool,
+    export_js_1.ExportTool,
+];
+//# sourceMappingURL=tools.js.map

package/dist/cjs/tools/mongodb/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/tools/mongodb/tools.ts"],"names":[],"mappings":";;;AAAA,qDAAmD;AACnD,sEAAoE;AACpE,sEAAoE;AACpE,kEAAgE;AAChE,4DAA0D;AAC1D,wEAAsE;AACtE,4CAA0C;AAC1C,0DAAwD;AACxD,0DAAwD;AACxD,kFAAgF;AAChF,8CAA4C;AAC5C,sDAAoD;AACpD,sDAAoD;AACpD,0DAAwD;AACxD,sEAAoE;AACpE,8DAA4D;AAC5D,kEAAgE;AAChE,sDAAoD;AACpD,sEAAoE;AACpE,gDAA8C;AAC9C,gDAA8C;AAEjC,QAAA,YAAY,GAAG;IACxB,wBAAW;IACX,wCAAmB;IACnB,oCAAiB;IACjB,4CAAqB;IACrB,gCAAe;IACf,0CAAoB;IACpB,kBAAQ;IACR,8BAAc;IACd,8BAAc;IACd,oDAAyB;IACzB,oBAAS;IACT,wBAAW;IACX,4BAAa;IACb,8BAAc;IACd,0CAAoB;IACpB,kCAAgB;IAChB,sCAAkB;IAClB,wBAAW;IACX,0CAAoB;IACpB,kBAAQ;IACR,sBAAU;CACb,CAAC"}

package/dist/cjs/tools/mongodb/update/renameCollection.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { MongoDBToolBase } from "../mongodbTool.js";
+import type { ToolArgs, OperationType } from "../../tool.js";
+export declare class RenameCollectionTool extends MongoDBToolBase {
+    name: string;
+    protected description: string;
+    protected argsShape: {
+        newName: z.ZodString;
+        dropTarget: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        database: z.ZodString;
+        collection: z.ZodString;
+    };
+    operationType: OperationType;
+    protected execute({ database, collection, newName, dropTarget, }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
+    protected handleError(error: unknown, args: ToolArgs<typeof this.argsShape>): Promise<CallToolResult> | CallToolResult;
+}
+//# sourceMappingURL=renameCollection.d.ts.map

package/dist/cjs/tools/mongodb/update/renameCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renameCollection.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mongodb/update/renameCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAmB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE7D,qBAAa,oBAAqB,SAAQ,eAAe;IAC9C,IAAI,SAAuB;IAClC,SAAS,CAAC,WAAW,SAAgD;IACrE,SAAS,CAAC,SAAS;;;;;MAIjB;IACK,aAAa,EAAE,aAAa,CAAY;cAE/B,OAAO,CAAC,EACpB,QAAQ,EACR,UAAU,EACV,OAAO,EACP,UAAU,GACb,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB5D,SAAS,CAAC,WAAW,CACjB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GACtC,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc;CA0B9C"}

package/dist/cjs/tools/mongodb/update/renameCollection.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenameCollectionTool = void 0;
+const zod_1 = require("zod");
+const mongodbTool_js_1 = require("../mongodbTool.js");
+class RenameCollectionTool extends mongodbTool_js_1.MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "rename-collection";
+        this.description = "Renames a collection in a MongoDB database";
+        this.argsShape = {
+            ...mongodbTool_js_1.DbOperationArgs,
+            newName: zod_1.z.string().describe("The new name for the collection"),
+            dropTarget: zod_1.z.boolean().optional().default(false).describe("If true, drops the target collection if it exists"),
+        };
+        this.operationType = "update";
+    }
+    async execute({ database, collection, newName, dropTarget, }) {
+        const provider = await this.ensureConnected();
+        const result = await provider.renameCollection(database, collection, newName, {
+            dropTarget,
+        });
+        return {
+            content: [
+                {
+                    text: `Collection "${collection}" renamed to "${result.collectionName}" in database "${database}".`,
+                    type: "text",
+                },
+            ],
+        };
+    }
+    handleError(error, args) {
+        if (error instanceof Error && "codeName" in error) {
+            switch (error.codeName) {
+                case "NamespaceNotFound":
+                    return {
+                        content: [
+                            {
+                                text: `Cannot rename "${args.database}.${args.collection}" because it doesn't exist.`,
+                                type: "text",
+                            },
+                        ],
+                    };
+                case "NamespaceExists":
+                    return {
+                        content: [
+                            {
+                                text: `Cannot rename "${args.database}.${args.collection}" to "${args.newName}" because the target collection already exists. If you want to overwrite it, set the "dropTarget" argument to true.`,
+                                type: "text",
+                            },
+                        ],
+                    };
+            }
+        }
+        return super.handleError(error, args);
+    }
+}
+exports.RenameCollectionTool = RenameCollectionTool;
+//# sourceMappingURL=renameCollection.js.map

package/dist/cjs/tools/mongodb/update/renameCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renameCollection.js","sourceRoot":"","sources":["../../../../../src/tools/mongodb/update/renameCollection.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,sDAAqE;AAGrE,MAAa,oBAAqB,SAAQ,gCAAe;IAAzD;;QACW,SAAI,GAAG,mBAAmB,CAAC;QACxB,gBAAW,GAAG,4CAA4C,CAAC;QAC3D,cAAS,GAAG;YAClB,GAAG,gCAAe;YAClB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC/D,UAAU,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;SAClH,CAAC;QACK,kBAAa,GAAkB,QAAQ,CAAC;IAoDnD,CAAC;IAlDa,KAAK,CAAC,OAAO,CAAC,EACpB,QAAQ,EACR,UAAU,EACV,OAAO,EACP,UAAU,GACoB;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE;YAC1E,UAAU;SACb,CAAC,CAAC;QAEH,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,eAAe,UAAU,iBAAiB,MAAM,CAAC,cAAc,kBAAkB,QAAQ,IAAI;oBACnG,IAAI,EAAE,MAAM;iBACf;aACJ;SACJ,CAAC;IACN,CAAC;IAES,WAAW,CACjB,KAAc,EACd,IAAqC;QAErC,IAAI,KAAK,YAAY,KAAK,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YAChD,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACrB,KAAK,mBAAmB;oBACpB,OAAO;wBACH,OAAO,EAAE;4BACL;gCACI,IAAI,EAAE,kBAAkB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,6BAA6B;gCACrF,IAAI,EAAE,MAAM;6BACf;yBACJ;qBACJ,CAAC;gBACN,KAAK,iBAAiB;oBAClB,OAAO;wBACH,OAAO,EAAE;4BACL;gCACI,IAAI,EAAE,kBAAkB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,SAAS,IAAI,CAAC,OAAO,qHAAqH;gCAClM,IAAI,EAAE,MAAM;6BACf;yBACJ;qBACJ,CAAC;YACV,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;CACJ;AA5DD,oDA4DC"}

package/dist/cjs/tools/mongodb/update/updateMany.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { MongoDBToolBase } from "../mongodbTool.js";
+import type { ToolArgs, OperationType } from "../../tool.js";
+export declare class UpdateManyTool extends MongoDBToolBase {
+    name: string;
+    protected description: string;
+    protected argsShape: {
+        filter: z.ZodOptional<z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>>;
+        update: z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
+        upsert: z.ZodOptional<z.ZodBoolean>;
+        database: z.ZodString;
+        collection: z.ZodString;
+    };
+    operationType: OperationType;
+    protected execute({ database, collection, filter, update, upsert, }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
+}
+//# sourceMappingURL=updateMany.d.ts.map

package/dist/cjs/tools/mongodb/update/updateMany.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateMany.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mongodb/update/updateMany.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAmB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG7D,qBAAa,cAAe,SAAQ,eAAe;IACxC,IAAI,SAAiB;IAC5B,SAAS,CAAC,WAAW,SAA4E;IACjG,SAAS,CAAC,SAAS;;;;;;MAiBjB;IACK,aAAa,EAAE,aAAa,CAAY;cAE/B,OAAO,CAAC,EACpB,QAAQ,EACR,UAAU,EACV,MAAM,EACN,MAAM,EACN,MAAM,GACT,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CAiD/D"}

package/dist/cjs/tools/mongodb/update/updateMany.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateManyTool = void 0;
+const zod_1 = require("zod");
+const mongodbTool_js_1 = require("../mongodbTool.js");
+const indexCheck_js_1 = require("../../../helpers/indexCheck.js");
+class UpdateManyTool extends mongodbTool_js_1.MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "update-many";
+        this.description = "Updates all documents that match the specified filter for a collection";
+        this.argsShape = {
+            ...mongodbTool_js_1.DbOperationArgs,
+            filter: zod_1.z
+                .object({})
+                .passthrough()
+                .optional()
+                .describe("The selection criteria for the update, matching the syntax of the filter argument of db.collection.updateOne()"),
+            update: zod_1.z
+                .object({})
+                .passthrough()
+                .describe("An update document describing the modifications to apply using update operator expressions"),
+            upsert: zod_1.z
+                .boolean()
+                .optional()
+                .describe("Controls whether to insert a new document if no documents match the filter"),
+        };
+        this.operationType = "update";
+    }
+    async execute({ database, collection, filter, update, upsert, }) {
+        const provider = await this.ensureConnected();
+        // Check if update operation uses an index if enabled
+        if (this.config.indexCheck) {
+            await (0, indexCheck_js_1.checkIndexUsage)(provider, database, collection, "updateMany", async () => {
+                return provider.runCommandWithCheck(database, {
+                    explain: {
+                        update: collection,
+                        updates: [
+                            {
+                                q: filter || {},
+                                u: update,
+                                upsert: upsert || false,
+                                multi: true,
+                            },
+                        ],
+                    },
+                    verbosity: "queryPlanner",
+                });
+            });
+        }
+        const result = await provider.updateMany(database, collection, filter, update, {
+            upsert,
+        });
+        let message = "";
+        if (result.matchedCount === 0 && result.modifiedCount === 0 && result.upsertedCount === 0) {
+            message = "No documents matched the filter.";
+        }
+        else {
+            message = `Matched ${result.matchedCount} document(s).`;
+            if (result.modifiedCount > 0) {
+                message += ` Modified ${result.modifiedCount} document(s).`;
+            }
+            if (result.upsertedCount > 0) {
+                message += ` Upserted ${result.upsertedCount} document with id: ${result.upsertedId?.toString()}.`;
+            }
+        }
+        return {
+            content: [
+                {
+                    text: message,
+                    type: "text",
+                },
+            ],
+        };
+    }
+}
+exports.UpdateManyTool = UpdateManyTool;
+//# sourceMappingURL=updateMany.js.map

package/dist/cjs/tools/mongodb/update/updateMany.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateMany.js","sourceRoot":"","sources":["../../../../../src/tools/mongodb/update/updateMany.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,sDAAqE;AAErE,kEAAiE;AAEjE,MAAa,cAAe,SAAQ,gCAAe;IAAnD;;QACW,SAAI,GAAG,aAAa,CAAC;QAClB,gBAAW,GAAG,wEAAwE,CAAC;QACvF,cAAS,GAAG;YAClB,GAAG,gCAAe;YAClB,MAAM,EAAE,OAAC;iBACJ,MAAM,CAAC,EAAE,CAAC;iBACV,WAAW,EAAE;iBACb,QAAQ,EAAE;iBACV,QAAQ,CACL,gHAAgH,CACnH;YACL,MAAM,EAAE,OAAC;iBACJ,MAAM,CAAC,EAAE,CAAC;iBACV,WAAW,EAAE;iBACb,QAAQ,CAAC,4FAA4F,CAAC;YAC3G,MAAM,EAAE,OAAC;iBACJ,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;SAC9F,CAAC;QACK,kBAAa,GAAkB,QAAQ,CAAC;IAyDnD,CAAC;IAvDa,KAAK,CAAC,OAAO,CAAC,EACpB,QAAQ,EACR,UAAU,EACV,MAAM,EACN,MAAM,EACN,MAAM,GACwB;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAE9C,qDAAqD;QACrD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACzB,MAAM,IAAA,+BAAe,EAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE;gBAC3E,OAAO,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE;oBAC1C,OAAO,EAAE;wBACL,MAAM,EAAE,UAAU;wBAClB,OAAO,EAAE;4BACL;gCACI,CAAC,EAAE,MAAM,IAAI,EAAE;gCACf,CAAC,EAAE,MAAM;gCACT,MAAM,EAAE,MAAM,IAAI,KAAK;gCACvB,KAAK,EAAE,IAAI;6BACd;yBACJ;qBACJ;oBACD,SAAS,EAAE,cAAc;iBAC5B,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE;YAC3E,MAAM;SACT,CAAC,CAAC;QAEH,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,MAAM,CAAC,YAAY,KAAK,CAAC,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;YACxF,OAAO,GAAG,kCAAkC,CAAC;QACjD,CAAC;aAAM,CAAC;YACJ,OAAO,GAAG,WAAW,MAAM,CAAC,YAAY,eAAe,CAAC;YACxD,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,aAAa,MAAM,CAAC,aAAa,eAAe,CAAC;YAChE,CAAC;YACD,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,aAAa,MAAM,CAAC,aAAa,sBAAsB,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC;YACvG,CAAC;QACL,CAAC;QAED,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,MAAM;iBACf;aACJ;SACJ,CAAC;IACN,CAAC;CACJ;AA9ED,wCA8EC"}

package/dist/cjs/tools/tool.d.ts

@@ -0,0 +1,49 @@
+import type { z, AnyZodObject } from "zod";
+import { type ZodRawShape, type ZodNever } from "zod";
+import type { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult, ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
+import type { Session } from "../common/session.js";
+import type { Telemetry } from "../telemetry/telemetry.js";
+import type { UserConfig } from "../common/config.js";
+import type { Server } from "../server.js";
+export type ToolArgs<Args extends ZodRawShape> = z.objectOutputType<Args, ZodNever>;
+export type OperationType = "metadata" | "read" | "create" | "delete" | "update" | "connect";
+export type ToolCategory = "mongodb" | "atlas";
+export type TelemetryToolMetadata = {
+    projectId?: string;
+    orgId?: string;
+};
+export declare abstract class ToolBase {
+    protected readonly session: Session;
+    protected readonly config: UserConfig;
+    protected readonly telemetry: Telemetry;
+    abstract name: string;
+    abstract category: ToolCategory;
+    abstract operationType: OperationType;
+    protected abstract description: string;
+    protected abstract argsShape: ZodRawShape;
+    protected get annotations(): ToolAnnotations;
+    protected abstract execute(...args: Parameters<ToolCallback<typeof this.argsShape>>): Promise<CallToolResult>;
+    constructor(session: Session, config: UserConfig, telemetry: Telemetry);
+    register(server: Server): boolean;
+    protected update?: (updates: {
+        name?: string;
+        description?: string;
+        inputSchema?: AnyZodObject;
+    }) => void;
+    protected verifyAllowed(): boolean;
+    protected handleError(error: unknown, args: ToolArgs<typeof this.argsShape>): Promise<CallToolResult> | CallToolResult;
+    protected abstract resolveTelemetryMetadata(...args: Parameters<ToolCallback<typeof this.argsShape>>): TelemetryToolMetadata;
+    /**
+     * Creates and emits a tool telemetry event
+     * @param startTime - Start time in milliseconds
+     * @param result - Whether the command succeeded or failed
+     * @param args - The arguments passed to the tool
+     */
+    private emitToolEvent;
+}
+export declare function formatUntrustedData(description: string, data?: string): {
+    text: string;
+    type: "text";
+}[];
+//# sourceMappingURL=tool.d.ts.map

package/dist/cjs/tools/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/tools/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AAC3C,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AACtD,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAS,WAAW,IAAI,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEpF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC7F,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC;AAC/C,MAAM,MAAM,qBAAqB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,8BAAsB,QAAQ;IA2CtB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO;IACnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU;IACrC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS;IA5C3C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,SAAgB,QAAQ,EAAE,YAAY,CAAC;IAEvC,SAAgB,aAAa,EAAE,aAAa,CAAC;IAE7C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEvC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAE1C,SAAS,KAAK,WAAW,IAAI,eAAe,CA2B3C;IAED,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;gBAGtF,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,SAAS;IAGpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IA4ExC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IAG1G,SAAS,CAAC,aAAa,IAAI,OAAO;IA6BlC,SAAS,CAAC,WAAW,CACjB,KAAK,EAAE,OAAO,EAEd,IAAI,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GACtC,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc;IAY3C,SAAS,CAAC,QAAQ,CAAC,wBAAwB,CACvC,GAAG,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GACzD,qBAAqB;IAExB;;;;;OAKG;YACW,aAAa;CAgC9B;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CA2BxG"}