mongodb-mcp-server 1.2.0 → 1.3.0-pre.2

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

@@ -1,18 +1,17 @@
-import type { z, AnyZodObject } from "zod";
+import type { z } 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 { ConnectionMetadata, TelemetryToolMetadata } from "../telemetry/types.js";
+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 declare const enum FeatureFlags {
-    VectorSearch = "vectorSearch"
-}
 /**
  * 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.
@@ -32,51 +31,369 @@ 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";
 /**
- * Telemetry metadata that can be provided by tools when emitting telemetry events.
- * For MongoDB tools, this is typically empty, while for Atlas tools, this should include
- * the project and organization IDs if available.
+ * 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 TelemetryToolMetadata = {
-    projectId?: string;
-    orgId?: string;
-    atlasLocaldeploymentId?: string;
-};
 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;
+    /**
+     * 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: ToolCallbackArgs<typeof this.argsShape>): Promise<CallToolResult>;
-    /** Get the confirmation message for the tool. Can be overridden to provide a more specific message. */
+    /**
+     * 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: 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.
+    /**
+     * 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: ToolCallbackArgs<typeof this.argsShape>): Promise<boolean>;
+    /**
+     * Access to the session instance. Provides access to MongoDB connections,
+     * loggers, connection manager, and other session-level resources.
+     */
     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;
-    protected update?: (updates: {
-        name?: string;
-        description?: string;
-        inputSchema?: AnyZodObject;
-    }) => void;
+    isEnabled(): boolean;
+    protected disable(): void;
+    protected enable(): void;
     protected verifyAllowed(): boolean;
+    /**
+     * 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: ToolArgs<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(result: CallToolResult, ...args: Parameters<ToolCallback<typeof this.argsShape>>): TelemetryToolMetadata;
     /**
      * Creates and emits a tool telemetry event
@@ -85,7 +402,8 @@ export declare abstract class ToolBase {
      * @param args - The arguments passed to the tool
      */
     private emitToolEvent;
-    protected isFeatureFlagEnabled(flag: FeatureFlags): boolean;
+    protected isFeatureEnabled(feature: PreviewFeature): boolean;
+    protected getConnectionInfoMetadata(): ConnectionMetadata;
 }
 /**
  * Formats potentially untrusted data to be included in tool responses. The data is wrapped in unique tags

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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"}