mongodb-mcp-server 1.3.0-pre.1 → 1.3.0

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

@@ -10,7 +10,6 @@ export class RenameCollectionTool extends MongoDBToolBase {
             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();
@@ -54,4 +53,5 @@ export class RenameCollectionTool extends MongoDBToolBase {
         return super.handleError(error, args);
     }
 }
+RenameCollectionTool.operationType = "update";
 //# sourceMappingURL=renameCollection.js.map

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

@@ -1 +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,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAAzD;;QACW,SAAI,GAAG,mBAAmB,CAAC;QACxB,gBAAW,GAAG,4CAA4C,CAAC;QAC3D,cAAS,GAAG;YAClB,GAAG,eAAe;YAClB,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;QACK,kBAAa,GAAkB,QAAQ,CAAC;IAsDnD,CAAC;IApDa,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;wBACD,OAAO,EAAE,IAAI;qBAChB,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;wBACD,OAAO,EAAE,IAAI;qBAChB,CAAC;YACV,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;CACJ"}
+{"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,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAAzD;;QACW,SAAI,GAAG,mBAAmB,CAAC;QACxB,gBAAW,GAAG,4CAA4C,CAAC;QAC3D,cAAS,GAAG;YAClB,GAAG,eAAe;YAClB,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;IAuDN,CAAC;IApDa,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;wBACD,OAAO,EAAE,IAAI;qBAChB,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;wBACD,OAAO,EAAE,IAAI;qBAChB,CAAC;YACV,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;;AArDM,kCAAa,GAAkB,QAAQ,AAA1B,CAA2B"}

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

@@ -12,7 +12,7 @@ export declare class UpdateManyTool extends MongoDBToolBase {
         database: z.ZodString;
         collection: z.ZodString;
     };
-    operationType: OperationType;
+    static operationType: OperationType;
     protected execute({ database, collection, filter, update, upsert, }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
 }
 //# sourceMappingURL=updateMany.d.ts.map

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

@@ -1 +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;AAI7D,qBAAa,cAAe,SAAQ,eAAe;IACxC,IAAI,SAAiB;IAC5B,SAAS,CAAC,WAAW,SAA4E;IACjG,SAAS,CAAC,SAAS;;;;;;MAcjB;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"}
+{"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;AAI7D,qBAAa,cAAe,SAAQ,eAAe;IACxC,IAAI,SAAiB;IAC5B,SAAS,CAAC,WAAW,SAA4E;IACjG,SAAS,CAAC,SAAS;;;;;;MAcjB;IACF,MAAM,CAAC,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/esm/tools/mongodb/update/updateMany.js

@@ -18,7 +18,6 @@ export class UpdateManyTool extends MongoDBToolBase {
                 .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();
@@ -67,4 +66,5 @@ export class UpdateManyTool extends MongoDBToolBase {
         };
     }
 }
+UpdateManyTool.operationType = "update";
 //# sourceMappingURL=updateMany.js.map

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

@@ -1 +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,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,OAAO,cAAe,SAAQ,eAAe;IAAnD;;QACW,SAAI,GAAG,aAAa,CAAC;QAClB,gBAAW,GAAG,wEAAwE,CAAC;QACvF,cAAS,GAAG;YAClB,GAAG,eAAe;YAClB,MAAM,EAAE,MAAM,EAAE;iBACX,QAAQ,EAAE;iBACV,QAAQ,CACL,gHAAgH,CACnH;YACL,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,CACrB,4FAA4F,CAC/F;YACD,MAAM,EAAE,CAAC;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,eAAe,CAAC,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"}
+{"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,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,OAAO,cAAe,SAAQ,eAAe;IAAnD;;QACW,SAAI,GAAG,aAAa,CAAC;QAClB,gBAAW,GAAG,wEAAwE,CAAC;QACvF,cAAS,GAAG;YAClB,GAAG,eAAe;YAClB,MAAM,EAAE,MAAM,EAAE;iBACX,QAAQ,EAAE;iBACV,QAAQ,CACL,gHAAgH,CACnH;YACL,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,CACrB,4FAA4F,CAC/F;YACD,MAAM,EAAE,CAAC;iBACJ,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;SAC9F,CAAC;IA0DN,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,eAAe,CAAC,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;;AAxDM,4BAAa,GAAkB,QAAQ,AAA1B,CAA2B"}

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

@@ -1,6 +1,4 @@
-import type { z } from "zod";
-import { type ZodRawShape, type ZodNever } from "zod";
-import type { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { z, ZodRawShape } from "zod";
 import type { CallToolResult, ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
 import type { Session } from "../common/session.js";
 import type { Telemetry } from "../telemetry/telemetry.js";
@@ -9,9 +7,12 @@ import type { UserConfig } from "../common/config/userConfig.js";
 import type { Server } from "../server.js";
 import type { Elicitation } from "../elicitation.js";
 import type { PreviewFeature } from "../common/schemas.js";
-export type ToolArgs<Args extends ZodRawShape> = z.objectOutputType<Args, ZodNever>;
-export type ToolCallbackArgs<Args extends ZodRawShape> = Parameters<ToolCallback<Args>>;
-export type ToolExecutionContext<Args extends ZodRawShape = ZodRawShape> = Parameters<ToolCallback<Args>>[1];
+export type ToolArgs<T extends ZodRawShape> = {
+    [K in keyof T]: z.infer<T[K]>;
+};
+export type ToolExecutionContext = {
+    signal: AbortSignal;
+};
 /**
  * The type of operation the tool performs. This is used when evaluating if a tool is allowed to run based on
  * the config's `disabledTools` and `readOnly` settings.
@@ -31,41 +32,372 @@ export type OperationType = "metadata" | "read" | "create" | "delete" | "update"
  * - `mongodb` is used for tools that interact with a MongoDB instance, such as finding documents,
  *   aggregating data, listing databases/collections/indexes, creating indexes, etc.
  * - `atlas` is used for tools that interact with MongoDB Atlas, such as listing clusters, creating clusters, etc.
+ * - `atlas-local` is used for tools that interact with local Atlas deployments.
  */
 export type ToolCategory = "mongodb" | "atlas" | "atlas-local";
+/**
+ * Parameters passed to the constructor of all tools that extends `ToolBase`.
+ *
+ * The MongoDB MCP Server automatically injects these parameters when
+ * constructing tools and registering to the MCP Server.
+ *
+ * See `Server.registerTools` method in `src/server.ts` for further reference.
+ */
 export type ToolConstructorParams = {
+    /**
+     * The category that the tool belongs to (injected from the static
+     * `category` property on the Tool class).
+     */
+    category: ToolCategory;
+    /**
+     * The type of operation the tool performs (injected from the static
+     * `operationType` property on the Tool class).
+     */
+    operationType: OperationType;
+    /**
+     * An instance of Session class providing access to MongoDB connections,
+     * loggers, etc.
+     *
+     * See `src/common/session.ts` for further reference.
+     */
     session: Session;
+    /**
+     * The configuration object that MCP session was started with.
+     *
+     * See `src/common/config/userConfig.ts` for further reference.
+     */
     config: UserConfig;
+    /**
+     * The telemetry service for tracking tool usage.
+     *
+     * See `src/telemetry/telemetry.ts` for further reference.
+     */
     telemetry: Telemetry;
+    /**
+     * The elicitation service for requesting user confirmation.
+     *
+     * See `src/elicitation.ts` for further reference.
+     */
     elicitation: Elicitation;
 };
+/**
+ * The type that all tool classes must conform to when implementing custom tools
+ * for the MongoDB MCP Server.
+ *
+ * This type enforces that tool classes have static properties `category` and
+ * `operationType` which are injected during instantiation of tool classes.
+ *
+ * @example
+ * ```typescript
+ * import { StreamableHttpRunner, UserConfigSchema } from "mongodb-mcp-server"
+ * import { ToolBase, type ToolClass, type ToolCategory, type OperationType } from "mongodb-mcp-server/tools";
+ * import { z } from "zod";
+ *
+ * class MyCustomTool extends ToolBase {
+ *   // Required static properties for ToolClass conformance
+ *   static category: ToolCategory = "mongodb";
+ *   static operationType: OperationType = "read";
+ *
+ *   // Required abstract properties
+ *   override name = "my-custom-tool";
+ *   protected description = "My custom tool description";
+ *   protected argsShape = {
+ *     query: z.string().describe("The query parameter"),
+ *   };
+ *
+ *   // Required abstract method: implement the tool's logic
+ *   protected async execute(args) {
+ *     // Tool implementation
+ *     return {
+ *       content: [{ type: "text", text: "Result" }],
+ *     };
+ *   }
+ *
+ *   // Required abstract method: provide telemetry metadata
+ *   protected resolveTelemetryMetadata() {
+ *     return {}; // Return empty object if no custom telemetry needed
+ *   }
+ * }
+ *
+ * const runner = new StreamableHttpRunner({
+ *   userConfig: UserConfigSchema.parse({}),
+ *   // This will work only if the class correctly conforms to ToolClass type, which in our case it does.
+ *   tools: [MyCustomTool],
+ * });
+ * ```
+ */
+export type ToolClass = {
+    /** Constructor signature for the tool class */
+    new (params: ToolConstructorParams): ToolBase;
+    /** The category that the tool belongs to */
+    category: ToolCategory;
+    /** The type of operation the tool performs */
+    operationType: OperationType;
+};
+/**
+ * Abstract base class for implementing MCP tools in the MongoDB MCP Server.
+ *
+ * All tools (both internal and custom) must extend this class to ensure a
+ * consistent interface and proper integration with the server.
+ *
+ * ## Creating a Custom Tool
+ *
+ * To create a custom tool, you must:
+ * 1. Extend the `ToolBase` class
+ * 2. Define static properties: `category` and `operationType`
+ * 3. Implement required abstract members: `name`, `description`,
+ *    `argsShape`, `execute()`, `resolveTelemetryMetadata()`
+ *
+ * @example Basic Custom Tool
+ * ```typescript
+ * import { StreamableHttpRunner, UserConfigSchema } from "mongodb-mcp-server"
+ * import { ToolBase, type ToolClass, type ToolCategory, type OperationType } from "mongodb-mcp-server/tools";
+ * import { z } from "zod";
+ *
+ * class MyCustomTool extends ToolBase {
+ *   // Required static property for ToolClass conformance
+ *   static category: ToolCategory = "mongodb";
+ *   static operationType: OperationType = "read";
+ *
+ *   // Required abstract properties
+ *   override name = "my-custom-tool";
+ *   protected description = "My custom tool description";
+ *   protected argsShape = {
+ *     query: z.string().describe("The query parameter"),
+ *   };
+ *
+ *   // Required abstract method: implement the tool's logic
+ *   protected async execute(args) {
+ *     // Tool implementation
+ *     return {
+ *       content: [{ type: "text", text: "Result" }],
+ *     };
+ *   }
+ *
+ *   // Required abstract method: provide telemetry metadata
+ *   protected resolveTelemetryMetadata() {
+ *     return {}; // Return empty object if no custom telemetry needed
+ *   }
+ * }
+ *
+ * const runner = new StreamableHttpRunner({
+ *   userConfig: UserConfigSchema.parse({}),
+ *   // This will work only if the class correctly conforms to ToolClass type, which in our case it does.
+ *   tools: [MyCustomTool],
+ * });
+ * ```
+ *
+ * ## Protected Members Available to Subclasses
+ *
+ * - `session` - Access to MongoDB connection, logger, and other session
+ *   resources
+ * - `config` - Server configuration (`UserConfig`)
+ * - `telemetry` - Telemetry service for tracking usage
+ * - `elicitation` - Service for requesting user confirmations
+ *
+ * ## Instance Properties Set by Constructor
+ *
+ * The following properties are automatically set when the tool is instantiated
+ * by the server (derived from the static properties):
+ * - `category` - The tool's category (from static `category`)
+ * - `operationType` - The tool's operation type (from static `operationType`)
+ *
+ * ## Optional Overrideable Methods
+ *
+ * - `getConfirmationMessage()` - Customize the confirmation prompt for tools
+ *   requiring user approval
+ * - `handleError()` - Customize error handling behavior
+ *
+ * @see {@link ToolClass} for the type that tool classes must conform to
+ * @see {@link ToolConstructorParams} for the parameters passed to the
+ * constructor
+ */
 export declare abstract class ToolBase {
+    /**
+     * The unique name of this tool.
+     *
+     * Must be unique across all tools in the server.
+     */
     abstract name: string;
-    abstract category: ToolCategory;
-    abstract operationType: OperationType;
+    /**
+     * The category of this tool.
+     *
+     * @see {@link ToolCategory} for the available tool categories.
+     */
+    category: ToolCategory;
+    /**
+     * The type of operation this tool performs.
+     *
+     * Automatically set from the static `operationType` property during
+     * construction.
+     *
+     * @see {@link OperationType} for the available tool operations.
+     */
+    operationType: OperationType;
+    /**
+     * Human-readable description of what the tool does.
+     *
+     * This is shown to the MCP client and helps the LLM understand when to use
+     * this tool.
+     */
     protected abstract description: string;
+    /**
+     * Zod schema defining the tool's arguments.
+     *
+     * Use an empty object `{}` if the tool takes no arguments.
+     *
+     * @example
+     * ```typescript
+     * protected argsShape = {
+     *   query: z.string().describe("The search query"),
+     *   limit: z.number().optional().describe("Maximum results to return"),
+     * };
+     * ```
+     */
     protected abstract argsShape: ZodRawShape;
     private registeredTool;
     protected get annotations(): ToolAnnotations;
-    protected abstract execute(...args: ToolCallbackArgs<typeof this.argsShape>): Promise<CallToolResult>;
-    /** Get the confirmation message for the tool. Can be overridden to provide a more specific message. */
-    protected getConfirmationMessage(...args: ToolCallbackArgs<typeof this.argsShape>): string;
-    /** Check if the user has confirmed the tool execution, if required by the configuration.
-     *  Always returns true if confirmation is not required.
+    /**
+     * A function that is registered as the tool execution callback and is
+     * called with the expected arguments.
+     *
+     * This is the core implementation of your tool's functionality. It receives
+     * validated arguments (validated against `argsShape`) and must return a
+     * result conforming to the MCP protocol.
+     *
+     * @param args - The validated arguments passed to the tool
+     * @returns A promise resolving to the tool execution result
+     *
+     * @example
+     * ```typescript
+     * protected async execute(args: { query: string }): Promise<CallToolResult> {
+     *   const results = await this.session.db.collection('items').find({
+     *     name: { $regex: args.query, $options: 'i' }
+     *   }).toArray();
+     *
+     *   return {
+     *     content: [{
+     *       type: "text",
+     *       text: JSON.stringify(results),
+     *     }],
+     *   };
+     * }
+     * ```
+     */
+    protected abstract execute(args: ToolArgs<typeof this.argsShape>, { signal }: ToolExecutionContext): Promise<CallToolResult>;
+    /**
+     * Get the confirmation message shown to users when this tool requires
+     * explicit approval.
+     *
+     * Override this method to provide a more specific and helpful confirmation
+     * message based on the tool's arguments.
+     *
+     * @param args - The tool arguments
+     * @returns The confirmation message to display to the user
+     *
+     * @example
+     * ```typescript
+     * protected getConfirmationMessage(args: { database: string }): string {
+     *   return `You are about to delete the database "${args.database}". This action cannot be undone. Proceed?`;
+     * }
+     * ```
+     */
+    protected getConfirmationMessage(args: ToolArgs<typeof this.argsShape>): string;
+    /**
+     * Check if the user has confirmed the tool execution (if required by
+     * configuration).
+     *
+     * This method automatically checks if the tool name is in the
+     * `confirmationRequiredTools` configuration list and requests user
+     * confirmation via the elicitation service if needed.
+     *
+     * @param args - The tool arguments
+     * @returns A promise resolving to `true` if confirmed or confirmation not
+     * required, `false` otherwise
+     */
+    verifyConfirmed(args: ToolArgs<typeof this.argsShape>): Promise<boolean>;
+    /**
+     * Access to the session instance. Provides access to MongoDB connections,
+     * loggers, connection manager, and other session-level resources.
      */
-    verifyConfirmed(args: ToolCallbackArgs<typeof this.argsShape>): Promise<boolean>;
     protected readonly session: Session;
+    /**
+     * Access to the server configuration. Contains all user configuration
+     * settings including connection strings, feature flags, and operational
+     * limits.
+     */
     protected readonly config: UserConfig;
+    /**
+     * Access to the telemetry service. Use this to emit custom telemetry events
+     * if needed.
+     */
     protected readonly telemetry: Telemetry;
+    /**
+     * Access to the elicitation service. Use this to request user confirmations
+     * or inputs during tool execution.
+     */
     protected readonly elicitation: Elicitation;
-    constructor({ session, config, telemetry, elicitation }: ToolConstructorParams);
+    constructor({ category, operationType, session, config, telemetry, elicitation }: ToolConstructorParams);
     register(server: Server): boolean;
     isEnabled(): boolean;
     protected disable(): void;
     protected enable(): void;
     protected verifyAllowed(): boolean;
-    protected handleError(error: unknown, args: ToolArgs<typeof this.argsShape>): Promise<CallToolResult> | CallToolResult;
-    protected abstract resolveTelemetryMetadata(result: CallToolResult, ...args: Parameters<ToolCallback<typeof this.argsShape>>): TelemetryToolMetadata;
+    /**
+     * Handle errors that occur during tool execution.
+     *
+     * Override this method to provide custom error handling logic. The default
+     * implementation returns a simple error message.
+     *
+     * @param error - The error that was thrown
+     * @param args - The arguments that were passed to the tool
+     * @returns A CallToolResult with error information
+     *
+     * @example
+     * ```typescript
+     * protected handleError(error: unknown, args: { query: string }): CallToolResult {
+     *   if (error instanceof MongoError && error.code === 11000) {
+     *     return {
+     *       content: [{
+     *         type: "text",
+     *         text: `Duplicate key error for query: ${args.query}`,
+     *       }],
+     *       isError: true,
+     *     };
+     *   }
+     *   // Fall back to default error handling
+     *   return super.handleError(error, args);
+     * }
+     * ```
+     */
+    protected handleError(error: unknown, args: z.infer<z.ZodObject<typeof this.argsShape>>): Promise<CallToolResult> | CallToolResult;
+    /**
+     * Resolve telemetry metadata for this tool execution.
+     *
+     * This method is called after every tool execution to collect metadata for
+     * telemetry events. Return an object with custom properties you want to
+     * track, or an empty object if no custom telemetry is needed.
+     *
+     * @param result - The result of the tool execution
+     * @param args - The arguments and context passed to the tool
+     * @returns An object containing telemetry metadata
+     *
+     * @example
+     * ```typescript
+     * protected resolveTelemetryMetadata(
+     *   result: CallToolResult,
+     *   args: { query: string }
+     * ): TelemetryToolMetadata {
+     *   return {
+     *     query_length: args.query.length,
+     *     result_count: result.isError ? 0 : JSON.parse(result.content[0].text).length,
+     *   };
+     * }
+     * ```
+     */
+    protected abstract resolveTelemetryMetadata(args: ToolArgs<typeof this.argsShape>, { result }: {
+        result: CallToolResult;
+    }): TelemetryToolMetadata;
     /**
      * Creates and emits a tool telemetry event
      * @param startTime - Start time in milliseconds

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

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