mongodb-mcp-server 0.0.4

package/dist/tools/mongodb/mongodbTool.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { ToolBase } from "../tool.js";
+import { NodeDriverServiceProvider } from "@mongosh/service-provider-node-driver";
+import { ErrorCodes, MongoDBError } from "../../errors.js";
+import config from "../../config.js";
+export const DbOperationArgs = {
+    database: z.string().describe("Database name"),
+    collection: z.string().describe("Collection name"),
+};
+export class MongoDBToolBase extends ToolBase {
+    constructor(session) {
+        super(session);
+        this.category = "mongodb";
+    }
+    async ensureConnected() {
+        if (!this.session.serviceProvider && config.connectionString) {
+            await this.connectToMongoDB(config.connectionString);
+        }
+        if (!this.session.serviceProvider) {
+            throw new MongoDBError(ErrorCodes.NotConnectedToMongoDB, "Not connected to MongoDB");
+        }
+        return this.session.serviceProvider;
+    }
+    handleError(error) {
+        if (error instanceof MongoDBError && error.code === ErrorCodes.NotConnectedToMongoDB) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "You need to connect to a MongoDB instance before you can access its data.",
+                    },
+                    {
+                        type: "text",
+                        text: "Please use the 'connect' tool to connect to a MongoDB instance.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return super.handleError(error);
+    }
+    async connectToMongoDB(connectionString) {
+        const provider = await NodeDriverServiceProvider.connect(connectionString, {
+            productDocsLink: "https://docs.mongodb.com/todo-mcp",
+            productName: "MongoDB MCP",
+            readConcern: {
+                level: config.connectOptions.readConcern,
+            },
+            readPreference: config.connectOptions.readPreference,
+            writeConcern: {
+                w: config.connectOptions.writeConcern,
+            },
+            timeoutMS: config.connectOptions.timeoutMS,
+        });
+        this.session.serviceProvider = provider;
+    }
+}
+//# sourceMappingURL=mongodbTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongodbTool.js","sourceRoot":"","sources":["../../../src/tools/mongodb/mongodbTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAElF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAErC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CACrD,CAAC;AAEF,MAAM,OAAgB,eAAgB,SAAQ,QAAQ;IAClD,YAAY,OAAgB;QACxB,KAAK,CAAC,OAAO,CAAC,CAAC;QAGT,aAAQ,GAAiB,SAAS,CAAC;IAF7C,CAAC;IAIS,KAAK,CAAC,eAAe;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC3D,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAChC,MAAM,IAAI,YAAY,CAAC,UAAU,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC;QACzF,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;IACxC,CAAC;IAES,WAAW,CAAC,KAAc;QAChC,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,qBAAqB,EAAE,CAAC;YACnF,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,2EAA2E;qBACpF;oBACD;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,iEAAiE;qBAC1E;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QAED,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAES,KAAK,CAAC,gBAAgB,CAAC,gBAAwB;QACrD,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,gBAAgB,EAAE;YACvE,eAAe,EAAE,mCAAmC;YACpD,WAAW,EAAE,aAAa;YAC1B,WAAW,EAAE;gBACT,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC,WAAW;aAC3C;YACD,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,cAAc;YACpD,YAAY,EAAE;gBACV,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,YAAY;aACxC;YACD,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,SAAS;SAC7C,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,eAAe,GAAG,QAAQ,CAAC;IAC5C,CAAC;CACJ"}

package/dist/tools/mongodb/read/aggregate.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { DbOperationArgs, MongoDBToolBase } from "../mongodbTool.js";
+export const AggregateArgs = {
+    pipeline: z.array(z.object({}).passthrough()).describe("An array of aggregation stages to execute"),
+    limit: z.number().optional().default(10).describe("The maximum number of documents to return"),
+};
+export class AggregateTool extends MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "aggregate";
+        this.description = "Run an aggregation against a MongoDB collection";
+        this.argsShape = {
+            ...DbOperationArgs,
+            ...AggregateArgs,
+        };
+        this.operationType = "read";
+    }
+    async execute({ database, collection, pipeline, }) {
+        const provider = await this.ensureConnected();
+        const documents = await provider.aggregate(database, collection, pipeline).toArray();
+        const content = [
+            {
+                text: `Found ${documents.length} documents in the collection \`${collection}\`:`,
+                type: "text",
+            },
+            ...documents.map((doc) => {
+                return {
+                    text: JSON.stringify(doc),
+                    type: "text",
+                };
+            }),
+        ];
+        return {
+            content,
+        };
+    }
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/tools/mongodb/read/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../../../../src/tools/mongodb/read/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACnG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACjG,CAAC;AAEF,MAAM,OAAO,aAAc,SAAQ,eAAe;IAAlD;;QACc,SAAI,GAAG,WAAW,CAAC;QACnB,gBAAW,GAAG,iDAAiD,CAAC;QAChE,cAAS,GAAG;YAClB,GAAG,eAAe;YAClB,GAAG,aAAa;SACnB,CAAC;QACQ,kBAAa,GAAkB,MAAM,CAAC;IA2BpD,CAAC;IAzBa,KAAK,CAAC,OAAO,CAAC,EACpB,QAAQ,EACR,UAAU,EACV,QAAQ,GACsB;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAErF,MAAM,OAAO,GAA0C;YACnD;gBACI,IAAI,EAAE,SAAS,SAAS,CAAC,MAAM,kCAAkC,UAAU,KAAK;gBAChF,IAAI,EAAE,MAAM;aACf;YACD,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACrB,OAAO;oBACH,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;oBACzB,IAAI,EAAE,MAAM;iBACmB,CAAC;YACxC,CAAC,CAAC;SACL,CAAC;QAEF,OAAO;YACH,OAAO;SACV,CAAC;IACN,CAAC;CACJ"}

package/dist/tools/mongodb/read/collectionIndexes.js

@@ -0,0 +1,23 @@
+import { DbOperationArgs, MongoDBToolBase } from "../mongodbTool.js";
+export class CollectionIndexesTool extends MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "collection-indexes";
+        this.description = "Describe the indexes for a collection";
+        this.argsShape = DbOperationArgs;
+        this.operationType = "read";
+    }
+    async execute({ database, collection }) {
+        const provider = await this.ensureConnected();
+        const indexes = await provider.getIndexes(database, collection);
+        return {
+            content: indexes.map((indexDefinition) => {
+                return {
+                    text: `Field: ${indexDefinition.name}: ${JSON.stringify(indexDefinition.key)}`,
+                    type: "text",
+                };
+            }),
+        };
+    }
+}
+//# sourceMappingURL=collectionIndexes.js.map

package/dist/tools/mongodb/read/collectionIndexes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectionIndexes.js","sourceRoot":"","sources":["../../../../src/tools/mongodb/read/collectionIndexes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IAA1D;;QACc,SAAI,GAAG,oBAAoB,CAAC;QAC5B,gBAAW,GAAG,uCAAuC,CAAC;QACtD,cAAS,GAAG,eAAe,CAAC;QAC5B,kBAAa,GAAkB,MAAM,CAAC;IAepD,CAAC;IAba,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAoC;QAC9E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAEhE,OAAO;YACH,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,EAAE;gBACrC,OAAO;oBACH,IAAI,EAAE,UAAU,eAAe,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE;oBAC9E,IAAI,EAAE,MAAM;iBACf,CAAC;YACN,CAAC,CAAC;SACL,CAAC;IACN,CAAC;CACJ"}

package/dist/tools/mongodb/read/count.js

@@ -0,0 +1,34 @@
+import { DbOperationArgs, MongoDBToolBase } from "../mongodbTool.js";
+import { z } from "zod";
+export const CountArgs = {
+    query: z
+        .object({})
+        .passthrough()
+        .optional()
+        .describe("The query filter to count documents. Matches the syntax of the filter argument of db.collection.count()"),
+};
+export class CountTool extends MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "count";
+        this.description = "Gets the number of documents in a MongoDB collection";
+        this.argsShape = {
+            ...DbOperationArgs,
+            ...CountArgs,
+        };
+        this.operationType = "read";
+    }
+    async execute({ database, collection, query }) {
+        const provider = await this.ensureConnected();
+        const count = await provider.count(database, collection, query);
+        return {
+            content: [
+                {
+                    text: `Found ${count} documents in the collection "${collection}"`,
+                    type: "text",
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=count.js.map

package/dist/tools/mongodb/read/count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count.js","sourceRoot":"","sources":["../../../../src/tools/mongodb/read/count.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,KAAK,EAAE,CAAC;SACH,MAAM,CAAC,EAAE,CAAC;SACV,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CACL,yGAAyG,CAC5G;CACR,CAAC;AAEF,MAAM,OAAO,SAAU,SAAQ,eAAe;IAA9C;;QACc,SAAI,GAAG,OAAO,CAAC;QACf,gBAAW,GAAG,sDAAsD,CAAC;QACrE,cAAS,GAAG;YAClB,GAAG,eAAe;YAClB,GAAG,SAAS;SACf,CAAC;QAEQ,kBAAa,GAAkB,MAAM,CAAC;IAepD,CAAC;IAba,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAmC;QACpF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAEhE,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,SAAS,KAAK,iCAAiC,UAAU,GAAG;oBAClE,IAAI,EAAE,MAAM;iBACf;aACJ;SACJ,CAAC;IACN,CAAC;CACJ"}

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

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { DbOperationArgs, MongoDBToolBase } from "../mongodbTool.js";
+export const FindArgs = {
+    filter: z
+        .object({})
+        .passthrough()
+        .optional()
+        .describe("The query filter, matching the syntax of the query argument of db.collection.find()"),
+    projection: z
+        .object({})
+        .passthrough()
+        .optional()
+        .describe("The projection, matching the syntax of the projection argument of db.collection.find()"),
+    limit: z.number().optional().default(10).describe("The maximum number of documents to return"),
+    sort: z
+        .record(z.string(), z.custom())
+        .optional()
+        .describe("A document, describing the sort order, matching the syntax of the sort argument of cursor.sort()"),
+};
+export class FindTool extends MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "find";
+        this.description = "Run a find query against a MongoDB collection";
+        this.argsShape = {
+            ...DbOperationArgs,
+            ...FindArgs,
+        };
+        this.operationType = "read";
+    }
+    async execute({ database, collection, filter, projection, limit, sort, }) {
+        const provider = await this.ensureConnected();
+        const documents = await provider.find(database, collection, filter, { projection, limit, sort }).toArray();
+        const content = [
+            {
+                text: `Found ${documents.length} documents in the collection \`${collection}\`:`,
+                type: "text",
+            },
+            ...documents.map((doc) => {
+                return {
+                    text: JSON.stringify(doc),
+                    type: "text",
+                };
+            }),
+        ];
+        return {
+            content,
+        };
+    }
+}
+//# sourceMappingURL=find.js.map

package/dist/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIrE,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,MAAM,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,CAAC;SACV,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,qFAAqF,CAAC;IACpG,UAAU,EAAE,CAAC;SACR,MAAM,CAAC,EAAE,CAAC;SACV,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,wFAAwF,CAAC;IACvG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC9F,IAAI,EAAE,CAAC;SACF,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAiB,CAAC;SAC7C,QAAQ,EAAE;SACV,QAAQ,CAAC,kGAAkG,CAAC;CACpH,CAAC;AAEF,MAAM,OAAO,QAAS,SAAQ,eAAe;IAA7C;;QACc,SAAI,GAAG,MAAM,CAAC;QACd,gBAAW,GAAG,+CAA+C,CAAC;QAC9D,cAAS,GAAG;YAClB,GAAG,eAAe;YAClB,GAAG,QAAQ;SACd,CAAC;QACQ,kBAAa,GAAkB,MAAM,CAAC;IA8BpD,CAAC;IA5Ba,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;QAC9C,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,MAAM,OAAO,GAA0C;YACnD;gBACI,IAAI,EAAE,SAAS,SAAS,CAAC,MAAM,kCAAkC,UAAU,KAAK;gBAChF,IAAI,EAAE,MAAM;aACf;YACD,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACrB,OAAO;oBACH,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;oBACzB,IAAI,EAAE,MAAM;iBACmB,CAAC;YACxC,CAAC,CAAC;SACL,CAAC;QAEF,OAAO;YACH,OAAO;SACV,CAAC;IACN,CAAC;CACJ"}

package/dist/tools/mongodb/tools.js

@@ -0,0 +1,41 @@
+import { ConnectTool } from "./metadata/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";
+export const MongoDbTools = [
+    ConnectTool,
+    ListCollectionsTool,
+    ListDatabasesTool,
+    CollectionIndexesTool,
+    CreateIndexTool,
+    CollectionSchemaTool,
+    FindTool,
+    InsertManyTool,
+    DeleteManyTool,
+    CollectionStorageSizeTool,
+    CountTool,
+    DbStatsTool,
+    AggregateTool,
+    UpdateManyTool,
+    RenameCollectionTool,
+    DropDatabaseTool,
+    DropCollectionTool,
+    ExplainTool,
+    CreateCollectionTool,
+];
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/tools/mongodb/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,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;AAEpE,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,WAAW;IACX,mBAAmB;IACnB,iBAAiB;IACjB,qBAAqB;IACrB,eAAe;IACf,oBAAoB;IACpB,QAAQ;IACR,cAAc;IACd,cAAc;IACd,yBAAyB;IACzB,SAAS;IACT,WAAW;IACX,aAAa;IACb,cAAc;IACd,oBAAoB;IACpB,gBAAgB;IAChB,kBAAkB;IAClB,WAAW;IACX,oBAAoB;CACvB,CAAC"}

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

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { MongoDBToolBase } from "../mongodbTool.js";
+export class RenameCollectionTool extends MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "rename-collection";
+        this.description = "Renames a collection in a MongoDB database";
+        this.argsShape = {
+            collection: z.string().describe("Collection name"),
+            database: z.string().describe("Database name"),
+            newName: z.string().describe("The new name for the collection"),
+            dropTarget: 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",
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=renameCollection.js.map

package/dist/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAAzD;;QACc,SAAI,GAAG,mBAAmB,CAAC;QAC3B,gBAAW,GAAG,4CAA4C,CAAC;QAC3D,cAAS,GAAG;YAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC/D,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;SAClH,CAAC;QACQ,kBAAa,GAAkB,QAAQ,CAAC;IAsBtD,CAAC;IApBa,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,gBAAgB,UAAU,mBAAmB,MAAM,CAAC,cAAc,oBAAoB,QAAQ,KAAK;oBACzG,IAAI,EAAE,MAAM;iBACf;aACJ;SACJ,CAAC;IACN,CAAC;CACJ"}

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

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { MongoDBToolBase } from "../mongodbTool.js";
+export class UpdateManyTool extends MongoDBToolBase {
+    constructor() {
+        super(...arguments);
+        this.name = "update-many";
+        this.description = "Updates all documents that match the specified filter for a collection";
+        this.argsShape = {
+            collection: z.string().describe("Collection name"),
+            database: z.string().describe("Database name"),
+            filter: z
+                .object({})
+                .passthrough()
+                .optional()
+                .describe("The selection criteria for the update, matching the syntax of the filter argument of db.collection.updateOne()"),
+            update: z
+                .object({})
+                .passthrough()
+                .optional()
+                .describe("An update document describing the modifications to apply using update operator expressions"),
+            upsert: 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();
+        const result = await provider.updateMany(database, collection, filter, update, {
+            upsert,
+        });
+        let message = "";
+        if (result.matchedCount === 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(s) (with id: ${result.upsertedId?.toString()}).`;
+            }
+        }
+        return {
+            content: [
+                {
+                    text: message,
+                    type: "text",
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=updateMany.js.map

package/dist/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,MAAM,OAAO,cAAe,SAAQ,eAAe;IAAnD;;QACc,SAAI,GAAG,aAAa,CAAC;QACrB,gBAAW,GAAG,wEAAwE,CAAC;QACvF,cAAS,GAAG;YAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YAC9C,MAAM,EAAE,CAAC;iBACJ,MAAM,CAAC,EAAE,CAAC;iBACV,WAAW,EAAE;iBACb,QAAQ,EAAE;iBACV,QAAQ,CACL,gHAAgH,CACnH;YACL,MAAM,EAAE,CAAC;iBACJ,MAAM,CAAC,EAAE,CAAC;iBACV,WAAW,EAAE;iBACb,QAAQ,EAAE;iBACV,QAAQ,CAAC,4FAA4F,CAAC;YAC3G,MAAM,EAAE,CAAC;iBACJ,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;SAC9F,CAAC;QACQ,kBAAa,GAAkB,QAAQ,CAAC;IAoCtD,CAAC;IAlCa,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;QAC9C,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,EAAE,CAAC;YAC5B,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,0BAA0B,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC;YAC5G,CAAC;QACL,CAAC;QAED,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,MAAM;iBACf;aACJ;SACJ,CAAC;IACN,CAAC;CACJ"}

package/dist/tools/tool.js

@@ -0,0 +1,56 @@
+import logger from "../logger.js";
+import { mongoLogId } from "mongodb-log-writer";
+import config from "../config.js";
+export class ToolBase {
+    constructor(session) {
+        this.session = session;
+    }
+    register(server) {
+        if (!this.verifyAllowed()) {
+            return;
+        }
+        const callback = async (...args) => {
+            try {
+                // TODO: add telemetry here
+                logger.debug(mongoLogId(1000006), "tool", `Executing ${this.name} with args: ${JSON.stringify(args)}`);
+                return await this.execute(...args);
+            }
+            catch (error) {
+                logger.error(mongoLogId(1000000), "tool", `Error executing ${this.name}: ${error}`);
+                return await this.handleError(error);
+            }
+        };
+        server.tool(this.name, this.description, this.argsShape, callback);
+    }
+    // Checks if a tool is allowed to run based on the config
+    verifyAllowed() {
+        let errorClarification;
+        if (config.disabledTools.includes(this.category)) {
+            errorClarification = `its category, \`${this.category}\`,`;
+        }
+        else if (config.disabledTools.includes(this.operationType)) {
+            errorClarification = `its operation type, \`${this.operationType}\`,`;
+        }
+        else if (config.disabledTools.includes(this.name)) {
+            errorClarification = `it`;
+        }
+        if (errorClarification) {
+            logger.debug(mongoLogId(1000010), "tool", `Prevented registration of ${this.name} because ${errorClarification} is disabled in the config`);
+            return false;
+        }
+        return true;
+    }
+    // This method is intended to be overridden by subclasses to handle errors
+    handleError(error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error running ${this.name}: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/tools/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAIA,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,MAAM,MAAM,cAAc,CAAC;AAOlC,MAAM,OAAgB,QAAQ;IAa1B,YAAgC,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAE7C,QAAQ,CAAC,MAAiB;QAC7B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QAED,MAAM,QAAQ,GAAwC,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;YACpE,IAAI,CAAC;gBACD,2BAA2B;gBAC3B,MAAM,CAAC,KAAK,CACR,UAAU,CAAC,OAAS,CAAC,EACrB,MAAM,EACN,aAAa,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAC9D,CAAC;gBAEF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACtB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAS,CAAC,EAAE,MAAM,EAAE,mBAAmB,IAAI,CAAC,IAAI,KAAK,KAAe,EAAE,CAAC,CAAC;gBAEhG,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED,yDAAyD;IACjD,aAAa;QACjB,IAAI,kBAAsC,CAAC;QAC3C,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,kBAAkB,GAAG,mBAAmB,IAAI,CAAC,QAAQ,KAAK,CAAC;QAC/D,CAAC;aAAM,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3D,kBAAkB,GAAG,yBAAyB,IAAI,CAAC,aAAa,KAAK,CAAC;QAC1E,CAAC;aAAM,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,kBAAkB,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,IAAI,kBAAkB,EAAE,CAAC;YACrB,MAAM,CAAC,KAAK,CACR,UAAU,CAAC,OAAS,CAAC,EACrB,MAAM,EACN,6BAA6B,IAAI,CAAC,IAAI,YAAY,kBAAkB,4BAA4B,CACnG,CAAC;YAEF,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,0EAA0E;IAChE,WAAW,CAAC,KAAc;QAChC,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iBAAiB,IAAI,CAAC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAChG;aACJ;YACD,OAAO,EAAE,IAAI;SAChB,CAAC;IACN,CAAC;CACJ"}

package/eslint.config.js

@@ -0,0 +1,35 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import js from "@eslint/js";
+import globals from "globals";
+import tseslint from "typescript-eslint";
+import eslintConfigPrettier from "eslint-config-prettier/flat";
+
+const files = ["src/**/*.ts", "scripts/**/*.ts", "tests/**/*.test.ts", "eslint.config.js", "jest.config.js"];
+
+export default defineConfig([
+    { files, plugins: { js }, extends: ["js/recommended"] },
+    { files, languageOptions: { globals: globals.node } },
+    tseslint.configs.recommendedTypeChecked,
+    {
+        languageOptions: {
+            parserOptions: {
+                projectService: true,
+                tsconfigRootDir: import.meta.dirname,
+            },
+        },
+    },
+    {
+        files,
+        rules: {
+            "@typescript-eslint/switch-exhaustiveness-check": "error",
+            "@typescript-eslint/no-non-null-assertion": "error",
+        },
+    },
+    // Ignore features specific to TypeScript resolved rules
+    tseslint.config({
+        // TODO: Configure tests and scripts to work with this.
+        ignores: ["eslint.config.js", "jest.config.js", "tests/**/*.ts", "scripts/**/*.ts"],
+    }),
+    globalIgnores(["node_modules", "dist", "src/common/atlas/openapi.d.ts", "coverage"]),
+    eslintConfigPrettier,
+]);

package/jest.config.js

@@ -0,0 +1,22 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} **/
+export default {
+    preset: "ts-jest/presets/default-esm",
+    testEnvironment: "node",
+    extensionsToTreatAsEsm: [".ts"],
+    testTimeout: 3600000, // 3600 seconds
+    moduleNameMapper: {
+        "^(\\.{1,2}/.*)\\.js$": "$1", // Map .js to real paths for ESM
+    },
+    transform: {
+        "^.+\\.tsx?$": [
+            "ts-jest",
+            {
+                useESM: true,
+                tsconfig: "tsconfig.jest.json", // Use specific tsconfig file for Jest
+            },
+        ],
+    },
+    moduleFileExtensions: ["ts", "tsx", "js", "jsx", "json", "node"],
+    setupFilesAfterEnv: ["jest-extended/all"],
+    coveragePathIgnorePatterns: ["node_modules", "tests", "dist"],
+};

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "mongodb-mcp-server",
+  "description": "MongoDB Model Context Protocol Server",
+  "version": "0.0.4",
+  "main": "dist/index.js",
+  "author": "MongoDB <info@mongodb.com>",
+  "homepage": "https://github.com/mongodb-js/mongodb-mcp-server",
+  "repository": {
+    "url": "https://github.com/mongodb-js/mongodb-mcp-server.git"
+  },
+  "bin": {
+    "mongodb-mcp-server": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "scripts": {
+    "prepare": "npm run build",
+    "build:clean": "rm -rf dist",
+    "build:compile": "tsc",
+    "build:chmod": "chmod +x dist/index.js",
+    "build": "npm run build:clean && npm run build:compile && npm run build:chmod",
+    "inspect": "npm run build && mcp-inspector -- dist/index.js",
+    "prettier": "prettier",
+    "check": "npm run build && npm run check:lint && npm run check:format",
+    "check:lint": "eslint .",
+    "check:format": "prettier -c .",
+    "reformat": "prettier --write .",
+    "generate": "./scripts/generate.sh",
+    "test": "jest --coverage"
+  },
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@jest/globals": "^29.7.0",
+    "@modelcontextprotocol/inspector": "^0.8.2",
+    "@redocly/cli": "^1.34.2",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.14.0",
+    "@types/simple-oauth2": "^5.0.7",
+    "@types/yargs-parser": "^21.0.3",
+    "eslint": "^9.24.0",
+    "eslint-config-prettier": "^10.1.1",
+    "globals": "^16.0.0",
+    "jest": "^29.7.0",
+    "jest-environment-node": "^29.7.0",
+    "jest-extended": "^4.0.2",
+    "mongodb-runner": "^5.8.2",
+    "openapi-types": "^12.1.3",
+    "openapi-typescript": "^7.6.1",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.3.1",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.29.1",
+    "yaml": "^2.7.1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.8.0",
+    "@mongodb-js/devtools-connect": "^3.7.2",
+    "@mongosh/service-provider-node-driver": "^3.6.0",
+    "bson": "^6.10.3",
+    "mongodb": "^6.15.0",
+    "mongodb-log-writer": "^2.4.1",
+    "mongodb-redact": "^1.1.6",
+    "mongodb-schema": "^12.6.2",
+    "openapi-fetch": "^0.13.5",
+    "simple-oauth2": "^5.1.0",
+    "yargs-parser": "^21.1.1",
+    "zod": "^3.24.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}