MongoDB MCP Server

Instructions

Implementation Reference

• src/tools/mongodb/connect/connect.ts:42-48 (handler)

  The execute method that handles the tool logic: connects to MongoDB using the session's connectToMongoDB with the given connection string and returns a success message.

  protected override async execute({ connectionString }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult> {
      await this.session.connectToMongoDB({ connectionString });
  
      return {
          content: [{ type: "text", text: "Successfully connected to MongoDB." }],
      };
  }

• src/tools/mongodb/connect/connect.ts:11-15 (schema)

  Input schema definition using Zod for the connectionString argument.

  // Here the default is empty just to trigger registration, but we're going to override it with the correct
  // schema in the register method.
  protected override argsShape = {
      connectionString: z.string().describe("MongoDB connection string (in the mongodb:// or mongodb+srv:// format)"),
  };

• src/tools/mongodb/tools.ts:1-1 (registration)

  Exports the ConnectTool class from its implementation file.

  export { ConnectTool } from "./connect/connect.js";

• src/tools/index.ts:7-11 (registration)

  Collects all tools including MongoDbTools (which includes ConnectTool) into AllTools array used by the server.

  export const AllTools: ToolClass[] = Object.values({
      ...MongoDbTools,
      ...AtlasTools,
      ...AtlasLocalTools,
  });

• src/server.ts:277-291 (registration)

  Registers all tools from toolConstructors (defaults to AllTools) by instantiating and calling register on each.

  private registerTools(): void {
      for (const toolConstructor of this.toolConstructors) {
          const tool = new toolConstructor({
              category: toolConstructor.category,
              operationType: toolConstructor.operationType,
              session: this.session,
              config: this.userConfig,
              telemetry: this.telemetry,
              elicitation: this.elicitation,
              uiRegistry: this.uiRegistry,
          });
          if (tool.register(this)) {
              this.tools.push(tool);
          }
      }