mongodb-mcp-server 0.1.3 → 0.3.0

package/dist/esm/resources/common/exportedData.js

@@ -0,0 +1,99 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LogId } from "../../common/logger.js";
+export class ExportedData {
+    constructor(session) {
+        this.session = session;
+        this.name = "exported-data";
+        this.description = "Data files exported in the current session.";
+        this.uri = "exported-data://{exportName}";
+        this.listResourcesCallback = () => {
+            try {
+                return {
+                    resources: this.session.exportsManager.availableExports.map(({ exportName, exportTitle, exportURI }) => ({
+                        name: exportName,
+                        description: exportTitle,
+                        uri: exportURI,
+                        mimeType: "application/json",
+                    })),
+                };
+            }
+            catch (error) {
+                this.session.logger.error({
+                    id: LogId.exportedDataListError,
+                    context: "Error when listing exported data resources",
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                return {
+                    resources: [],
+                };
+            }
+        };
+        this.autoCompleteExportName = (value) => {
+            try {
+                return this.session.exportsManager.availableExports
+                    .filter(({ exportName }) => exportName.startsWith(value))
+                    .map(({ exportName }) => exportName);
+            }
+            catch (error) {
+                this.session.logger.error({
+                    id: LogId.exportedDataAutoCompleteError,
+                    context: "Error when autocompleting exported data",
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                return [];
+            }
+        };
+        this.readResourceCallback = async (url, { exportName }) => {
+            try {
+                if (typeof exportName !== "string") {
+                    throw new Error("Cannot retrieve exported data, exportName not provided.");
+                }
+                const content = await this.session.exportsManager.readExport(exportName);
+                return {
+                    contents: [
+                        {
+                            uri: url.href,
+                            text: content,
+                            mimeType: "application/json",
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    contents: [
+                        {
+                            uri: url.href,
+                            text: `Error reading ${url.href}: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        };
+    }
+    register(server) {
+        this.server = server;
+        this.server.mcpServer.registerResource(this.name, new ResourceTemplate(this.uri, {
+            /**
+             * A few clients have the capability of listing templated
+             * resources as well and this callback provides support for that
+             * */
+            list: this.listResourcesCallback,
+            /**
+             * This is to provide auto completion when user starts typing in
+             * value for template variable, in our case, exportName */
+            complete: {
+                exportName: this.autoCompleteExportName,
+            },
+        }), { description: this.description }, this.readResourceCallback);
+        this.session.exportsManager.on("export-available", (uri) => {
+            server.sendResourceListChanged();
+            server.sendResourceUpdated(uri);
+        });
+        this.session.exportsManager.on("export-expired", () => {
+            server.sendResourceListChanged();
+        });
+    }
+}
+//# sourceMappingURL=exportedData.js.map

package/dist/esm/resources/common/exportedData.js.map

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

package/dist/esm/resources/resource.d.ts

@@ -0,0 +1,44 @@
+import type { Server } from "../server.js";
+import type { Session } from "../common/session.js";
+import type { UserConfig } from "../common/config.js";
+import type { Telemetry } from "../telemetry/telemetry.js";
+import type { SessionEvents } from "../common/session.js";
+import type { ResourceMetadata } from "@modelcontextprotocol/sdk/server/mcp.js";
+type PayloadOf<K extends keyof SessionEvents> = SessionEvents[K][0];
+export type ResourceConfiguration = {
+    name: string;
+    uri: string;
+    config: ResourceMetadata;
+};
+export type ReactiveResourceOptions<Value, RelevantEvents extends readonly (keyof SessionEvents)[]> = {
+    initial: Value;
+    events: RelevantEvents;
+};
+export declare abstract class ReactiveResource<Value, RelevantEvents extends readonly (keyof SessionEvents)[]> {
+    protected server?: Server;
+    protected session: Session;
+    protected config: UserConfig;
+    protected telemetry: Telemetry;
+    protected current: Value;
+    protected readonly name: string;
+    protected readonly uri: string;
+    protected readonly resourceConfig: ResourceMetadata;
+    protected readonly events: RelevantEvents;
+    constructor({ resourceConfiguration, options, session, config, telemetry, current, }: {
+        resourceConfiguration: ResourceConfiguration;
+        options: ReactiveResourceOptions<Value, RelevantEvents>;
+        session: Session;
+        config: UserConfig;
+        telemetry: Telemetry;
+        current?: Value;
+    });
+    private setupEventListeners;
+    register(server: Server): void;
+    private resourceCallback;
+    private triggerUpdate;
+    reduceApply(eventName: RelevantEvents[number], ...event: PayloadOf<RelevantEvents[number]>[]): void;
+    protected abstract reduce(eventName: RelevantEvents[number], ...event: PayloadOf<RelevantEvents[number]>[]): Value;
+    abstract toOutput(): string;
+}
+export {};
+//# sourceMappingURL=resource.d.ts.map

package/dist/esm/resources/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/resources/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAGtG,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,qBAAqB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,KAAK,EAAE,cAAc,SAAS,SAAS,CAAC,MAAM,aAAa,CAAC,EAAE,IAAI;IAClG,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,8BAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,SAAS,SAAS,CAAC,MAAM,aAAa,CAAC,EAAE;IACjG,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC;IAC7B,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;IAE/B,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC;IACzB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAE9B,EACR,qBAAqB,EACrB,OAAO,EACP,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,GACV,EAAE;QACC,qBAAqB,EAAE,qBAAqB,CAAC;QAC7C,OAAO,EAAE,uBAAuB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,UAAU,CAAC;QACnB,SAAS,EAAE,SAAS,CAAC;QACrB,OAAO,CAAC,EAAE,KAAK,CAAC;KACnB;IAcD,OAAO,CAAC,mBAAmB;IASpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKrC,OAAO,CAAC,gBAAgB,CAQrB;IAEH,OAAO,CAAC,aAAa;IAad,WAAW,CAAC,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI;IAI1G,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,KAAK;aAClG,QAAQ,IAAI,MAAM;CACrC"}

package/dist/esm/resources/resource.js

@@ -0,0 +1,52 @@
+import { LogId } from "../common/logger.js";
+export class ReactiveResource {
+    constructor({ resourceConfiguration, options, session, config, telemetry, current, }) {
+        this.resourceCallback = (uri) => ({
+            contents: [
+                {
+                    text: this.toOutput(),
+                    mimeType: "application/json",
+                    uri: uri.href,
+                },
+            ],
+        });
+        this.session = session;
+        this.config = config;
+        this.telemetry = telemetry;
+        this.name = resourceConfiguration.name;
+        this.uri = resourceConfiguration.uri;
+        this.resourceConfig = resourceConfiguration.config;
+        this.events = options.events;
+        this.current = current ?? options.initial;
+        this.setupEventListeners();
+    }
+    setupEventListeners() {
+        for (const event of this.events) {
+            this.session.on(event, (...args) => {
+                this.reduceApply(event, args[0]);
+                void this.triggerUpdate();
+            });
+        }
+    }
+    register(server) {
+        this.server = server;
+        this.server.mcpServer.registerResource(this.name, this.uri, this.resourceConfig, this.resourceCallback);
+    }
+    triggerUpdate() {
+        try {
+            this.server?.sendResourceListChanged();
+            this.server?.sendResourceUpdated(this.uri);
+        }
+        catch (error) {
+            this.session.logger.warning({
+                id: LogId.resourceUpdateFailure,
+                context: "resource",
+                message: `Could not send the latest resources to the client: ${error}`,
+            });
+        }
+    }
+    reduceApply(eventName, ...event) {
+        this.current = this.reduce(eventName, ...event);
+    }
+}
+//# sourceMappingURL=resource.js.map

package/dist/esm/resources/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../src/resources/resource.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAe5C,MAAM,OAAgB,gBAAgB;IAYlC,YAAY,EACR,qBAAqB,EACrB,OAAO,EACP,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,GAQV;QA4BO,qBAAgB,GAAyB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACvD,QAAQ,EAAE;gBACN;oBACI,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;oBACrB,QAAQ,EAAE,kBAAkB;oBAC5B,GAAG,EAAE,GAAG,CAAC,IAAI;iBAChB;aACJ;SACJ,CAAC,CAAC;QAnCC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;QACvC,IAAI,CAAC,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,qBAAqB,CAAC,MAAM,CAAC;QACnD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;QAE1C,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC/B,CAAC;IAEO,mBAAmB;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAiC,EAAE,EAAE;gBAC5D,IAAI,CAAC,WAAW,CAAC,KAAK,EAAG,IAAkB,CAAC,CAAC,CAA4B,CAAC,CAAC;gBAC3E,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9B,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5G,CAAC;IAYO,aAAa;QACjB,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;gBACxB,EAAE,EAAE,KAAK,CAAC,qBAAqB;gBAC/B,OAAO,EAAE,UAAU;gBACnB,OAAO,EAAE,sDAAsD,KAAe,EAAE;aACnF,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAEM,WAAW,CAAC,SAAiC,EAAE,GAAG,KAA0C;QAC/F,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC;IACpD,CAAC;CAIJ"}

package/dist/esm/resources/resources.d.ts

@@ -0,0 +1,5 @@
+import { ConfigResource } from "./common/config.js";
+import { DebugResource } from "./common/debug.js";
+import { ExportedData } from "./common/exportedData.js";
+export declare const Resources: readonly [typeof ConfigResource, typeof DebugResource, typeof ExportedData];
+//# sourceMappingURL=resources.d.ts.map

package/dist/esm/resources/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/resources/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,eAAO,MAAM,SAAS,6EAAyD,CAAC"}

package/dist/esm/resources/resources.js

@@ -0,0 +1,5 @@
+import { ConfigResource } from "./common/config.js";
+import { DebugResource } from "./common/debug.js";
+import { ExportedData } from "./common/exportedData.js";
+export const Resources = [ConfigResource, DebugResource, ExportedData];
+//# sourceMappingURL=resources.js.map

package/dist/esm/resources/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/resources/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,cAAc,EAAE,aAAa,EAAE,YAAY,CAAU,CAAC"}

package/dist/esm/server.d.ts

@@ -0,0 +1,40 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Session } from "./common/session.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { LogLevel } from "./common/logger.js";
+import type { Telemetry } from "./telemetry/telemetry.js";
+import type { UserConfig } from "./common/config.js";
+import type { ToolBase } from "./tools/tool.js";
+export interface ServerOptions {
+    session: Session;
+    userConfig: UserConfig;
+    mcpServer: McpServer;
+    telemetry: Telemetry;
+}
+export declare class Server {
+    readonly session: Session;
+    readonly mcpServer: McpServer;
+    private readonly telemetry;
+    readonly userConfig: UserConfig;
+    readonly tools: ToolBase[];
+    private _mcpLogLevel;
+    get mcpLogLevel(): LogLevel;
+    private readonly startTime;
+    private readonly subscriptions;
+    constructor({ session, mcpServer, userConfig, telemetry }: ServerOptions);
+    connect(transport: Transport): Promise<void>;
+    close(): Promise<void>;
+    sendResourceListChanged(): void;
+    sendResourceUpdated(uri: string): void;
+    /**
+     * Emits a server event
+     * @param command - The server command (e.g., "start", "stop", "register", "deregister")
+     * @param additionalProperties - Additional properties specific to the event
+     */
+    private emitServerEvent;
+    private registerTools;
+    private registerResources;
+    private validateConfig;
+    private connectToConfigConnectionString;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/esm/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAI/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAWrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;CACxB;AAED,qBAAa,MAAM;IACf,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,SAAgB,UAAU,EAAE,UAAU,CAAC;IACvC,SAAgB,KAAK,EAAE,QAAQ,EAAE,CAAM;IAEvC,OAAO,CAAC,YAAY,CAAqB;IAEzC,IAAW,WAAW,IAAI,QAAQ,CAEjC;IAED,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;gBAEvC,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,aAAa;IAQlE,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAsF5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,uBAAuB,IAAI,IAAI;IAI/B,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM7C;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,iBAAiB;YAOX,cAAc;YAiCd,+BAA+B;CAehD"}

package/dist/{server.js → esm/server.js}

@@ -1,11 +1,18 @@
 import { AtlasTools } from "./tools/atlas/tools.js";
 import { MongoDbTools } from "./tools/mongodb/tools.js";
-import logger, { initializeLogger, LogId } from "./logger.js";
-import { ObjectId } from "mongodb";
-import { CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { Resources } from "./resources/resources.js";
+import { LogId } from "./common/logger.js";
+import { CallToolRequestSchema, SetLevelRequestSchema, SubscribeRequestSchema, UnsubscribeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import assert from "assert";
+import { validateConnectionString } from "./helpers/connectionOptions.js";
 export class Server {
+    get mcpLogLevel() {
+        return this._mcpLogLevel;
+    }
     constructor({ session, mcpServer, userConfig, telemetry }) {
+        this.tools = [];
+        this._mcpLogLevel = "debug";
+        this.subscriptions = new Set();
         this.startTime = Date.now();
         this.session = session;
         this.telemetry = telemetry;
@@ -13,9 +20,13 @@ export class Server {
         this.userConfig = userConfig;
     }
     async connect(transport) {
-        this.mcpServer.server.registerCapabilities({ logging: {} });
-        this.registerTools();
+        // Resources are now reactive, so we register them ASAP so they can listen to events like
+        // connection events.
         this.registerResources();
+        await this.validateConfig();
+        this.mcpServer.server.registerCapabilities({ logging: {}, resources: { listChanged: true, subscribe: true } });
+        // TODO: Eventually we might want to make tools reactive too instead of relying on custom logic.
+        this.registerTools();
         // This is a workaround for an issue we've seen with some models, where they'll see that everything in the `arguments`
         // object is optional, and then not pass it at all. However, the MCP server expects the `arguments` object to be if
         // the tool accepts any arguments, even if they're all optional.
@@ -30,12 +41,37 @@ export class Server {
             }
             return existingHandler(request, extra);
         });
-        await initializeLogger(this.mcpServer, this.userConfig.logPath);
-        await this.mcpServer.connect(transport);
+        this.mcpServer.server.setRequestHandler(SubscribeRequestSchema, ({ params }) => {
+            this.subscriptions.add(params.uri);
+            this.session.logger.debug({
+                id: LogId.serverInitialized,
+                context: "resources",
+                message: `Client subscribed to resource: ${params.uri}`,
+            });
+            return {};
+        });
+        this.mcpServer.server.setRequestHandler(UnsubscribeRequestSchema, ({ params }) => {
+            this.subscriptions.delete(params.uri);
+            this.session.logger.debug({
+                id: LogId.serverInitialized,
+                context: "resources",
+                message: `Client unsubscribed from resource: ${params.uri}`,
+            });
+            return {};
+        });
+        this.mcpServer.server.setRequestHandler(SetLevelRequestSchema, ({ params }) => {
+            this._mcpLogLevel = params.level;
+            return {};
+        });
         this.mcpServer.server.oninitialized = () => {
-            this.session.setAgentRunner(this.mcpServer.server.getClientVersion());
-            this.session.sessionId = new ObjectId().toString();
-            logger.info(LogId.serverInitialized, "server", `Server started with transport ${transport.constructor.name} and agent runner ${this.session.agentRunner?.name}`);
+            this.session.setMcpClient(this.mcpServer.server.getClientVersion());
+            // Placed here to start the connection to the config connection string as soon as the server is initialized.
+            void this.connectToConfigConnectionString();
+            this.session.logger.info({
+                id: LogId.serverInitialized,
+                context: "server",
+                message: `Server started with transport ${transport.constructor.name} and agent runner ${this.session.mcpClient?.name}`,
+            });
             this.emitServerEvent("start", Date.now() - this.startTime);
         };
         this.mcpServer.server.onclose = () => {
@@ -46,13 +82,21 @@ export class Server {
             const closeTime = Date.now();
             this.emitServerEvent("stop", Date.now() - closeTime, error);
         };
-        await this.validateConfig();
+        await this.mcpServer.connect(transport);
     }
     async close() {
         await this.telemetry.close();
         await this.session.close();
         await this.mcpServer.close();
     }
+    sendResourceListChanged() {
+        this.mcpServer.sendResourceListChanged();
+    }
+    sendResourceUpdated(uri) {
+        if (this.subscriptions.has(uri)) {
+            void this.mcpServer.server.sendResourceUpdated({ uri });
+        }
+    }
     /**
      * Emits a server event
      * @param command - The server command (e.g., "start", "stop", "register", "deregister")
@@ -85,46 +129,32 @@ export class Server {
         this.telemetry.emitEvents([event]).catch(() => { });
     }
     registerTools() {
-        for (const tool of [...AtlasTools, ...MongoDbTools]) {
-            new tool(this.session, this.userConfig, this.telemetry).register(this.mcpServer);
+        for (const toolConstructor of [...AtlasTools, ...MongoDbTools]) {
+            const tool = new toolConstructor(this.session, this.userConfig, this.telemetry);
+            if (tool.register(this)) {
+                this.tools.push(tool);
+            }
         }
     }
     registerResources() {
-        this.mcpServer.resource("config", "config://config", {
-            description: "Server configuration, supplied by the user either as environment variables or as startup arguments",
-        }, (uri) => {
-            const result = {
-                telemetry: this.userConfig.telemetry,
-                logPath: this.userConfig.logPath,
-                connectionString: this.userConfig.connectionString
-                    ? "set; access to MongoDB tools are currently available to use"
-                    : "not set; before using any MongoDB tool, you need to configure a connection string, alternatively you can setup MongoDB Atlas access, more info at 'https://github.com/mongodb-js/mongodb-mcp-server'.",
-                connectOptions: this.userConfig.connectOptions,
-                atlas: this.userConfig.apiClientId && this.userConfig.apiClientSecret
-                    ? "set; MongoDB Atlas tools are currently available to use"
-                    : "not set; MongoDB Atlas tools are currently unavailable, to have access to MongoDB Atlas tools like creating clusters or connecting to clusters make sure to setup credentials, more info at 'https://github.com/mongodb-js/mongodb-mcp-server'.",
-            };
-            return {
-                contents: [
-                    {
-                        text: JSON.stringify(result),
-                        mimeType: "application/json",
-                        uri: uri.href,
-                    },
-                ],
-            };
-        });
+        for (const resourceConstructor of Resources) {
+            const resource = new resourceConstructor(this.session, this.userConfig, this.telemetry);
+            resource.register(this);
+        }
     }
     async validateConfig() {
+        // Validate connection string
         if (this.userConfig.connectionString) {
             try {
-                await this.session.connectToMongoDB(this.userConfig.connectionString, this.userConfig.connectOptions);
+                validateConnectionString(this.userConfig.connectionString, false);
             }
             catch (error) {
-                console.error("Failed to connect to MongoDB instance using the connection string from the config: ", error);
-                throw new Error("Failed to connect to MongoDB instance using the connection string from the config");
+                console.error("Connection string validation failed with error: ", error);
+                throw new Error("Connection string validation failed with error: " +
+                    (error instanceof Error ? error.message : String(error)));
             }
         }
+        // Validate API client credentials
         if (this.userConfig.apiClientId && this.userConfig.apiClientSecret) {
             try {
                 await this.session.apiClient.validateAccessToken();
@@ -138,5 +168,18 @@ export class Server {
             }
         }
     }
+    async connectToConfigConnectionString() {
+        if (this.userConfig.connectionString) {
+            try {
+                await this.session.connectToMongoDB({
+                    connectionString: this.userConfig.connectionString,
+                });
+            }
+            catch (error) {
+                console.error("Failed to connect to MongoDB instance using the connection string from the config: ", error);
+                throw new Error("Failed to connect to MongoDB instance using the connection string from the config");
+            }
+        }
+    }
 }
 //# sourceMappingURL=server.js.map

package/dist/esm/server.js.map

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

package/dist/esm/telemetry/constants.d.ts

@@ -0,0 +1,6 @@
+import { type CommonStaticProperties } from "./types.js";
+/**
+ * Machine-specific metadata formatted for telemetry
+ */
+export declare const MACHINE_METADATA: CommonStaticProperties;
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/telemetry/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/telemetry/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,sBAOrB,CAAC"}

package/dist/{telemetry → esm/telemetry}/constants.js

@@ -1,4 +1,4 @@
-import { packageInfo } from "../helpers/packageInfo.js";
+import { packageInfo } from "../common/packageInfo.js";
 /**
  * Machine-specific metadata formatted for telemetry
  */

package/dist/esm/telemetry/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/telemetry/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACpD,kBAAkB,EAAE,WAAW,CAAC,OAAO;IACvC,eAAe,EAAE,WAAW,CAAC,aAAa;IAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,OAAO,EAAE,OAAO,CAAC,QAAQ;IACzB,UAAU,EAAE,OAAO,CAAC,OAAO;CACrB,CAAC"}

package/dist/esm/telemetry/eventCache.d.ts

@@ -0,0 +1,34 @@
+import type { BaseEvent } from "./types.js";
+/**
+ * Singleton class for in-memory telemetry event caching
+ * Provides a central storage for telemetry events that couldn't be sent
+ * Uses LRU cache to automatically drop oldest events when limit is exceeded
+ */
+export declare class EventCache {
+    private static instance;
+    private static readonly MAX_EVENTS;
+    private cache;
+    private nextId;
+    constructor();
+    /**
+     * Gets the singleton instance of EventCache
+     * @returns The EventCache instance
+     */
+    static getInstance(): EventCache;
+    /**
+     * Gets a copy of the currently cached events
+     * @returns Array of cached BaseEvent objects
+     */
+    getEvents(): BaseEvent[];
+    /**
+     * Appends new events to the cached events
+     * LRU cache automatically handles dropping oldest events when limit is exceeded
+     * @param events - The events to append
+     */
+    appendEvents(events: BaseEvent[]): void;
+    /**
+     * Clears all cached events
+     */
+    clearEvents(): void;
+}
+//# sourceMappingURL=eventCache.d.ts.map

package/dist/esm/telemetry/eventCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventCache.d.ts","sourceRoot":"","sources":["../../../src/telemetry/eventCache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAa;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAE1C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,MAAM,CAAK;;IAWnB;;;OAGG;WACW,WAAW,IAAI,UAAU;IAOvC;;;OAGG;IACI,SAAS,IAAI,SAAS,EAAE;IAI/B;;;;OAIG;IACI,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAM9C;;OAEG;IACI,WAAW,IAAI,IAAI;CAI7B"}

package/dist/esm/telemetry/eventCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventCache.js","sourceRoot":"","sources":["../../../src/telemetry/eventCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAOnB;QAFQ,WAAM,GAAG,CAAC,CAAC;QAGf,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC;YACtB,GAAG,EAAE,UAAU,CAAC,UAAU;YAC1B,0CAA0C;YAC1C,UAAU,EAAE,KAAK;YACjB,cAAc,EAAE,KAAK;SACxB,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,WAAW;QACrB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACvB,UAAU,CAAC,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACI,SAAS;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,YAAY,CAAC,MAAmB;QACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,WAAW;QACd,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC;;AAlDuB,qBAAU,GAAG,IAAI,AAAP,CAAQ"}

package/dist/esm/telemetry/telemetry.d.ts

@@ -0,0 +1,50 @@
+import type { Session } from "../common/session.js";
+import type { BaseEvent, CommonProperties } from "./types.js";
+import type { UserConfig } from "../common/config.js";
+import { EventCache } from "./eventCache.js";
+import type { DeviceId } from "../helpers/deviceId.js";
+export declare class Telemetry {
+    private readonly session;
+    private readonly userConfig;
+    private readonly commonProperties;
+    private isBufferingEvents;
+    /** Resolves when the setup is complete or a timeout occurs */
+    setupPromise: Promise<[string, boolean]> | undefined;
+    private eventCache;
+    private deviceId;
+    private constructor();
+    static create(session: Session, userConfig: UserConfig, deviceId: DeviceId, { commonProperties, eventCache, }?: {
+        eventCache?: EventCache;
+        commonProperties?: CommonProperties;
+    }): Telemetry;
+    private setup;
+    close(): Promise<void>;
+    /**
+     * Emits events through the telemetry pipeline
+     * @param events - The events to emit
+     */
+    emitEvents(events: BaseEvent[]): Promise<void>;
+    /**
+     * Gets the common properties for events
+     * @returns Object containing common properties for all events
+     */
+    getCommonProperties(): CommonProperties;
+    /**
+     * Checks if telemetry is currently enabled
+     * This is a method rather than a constant to capture runtime config changes
+     *
+     * Follows the Console Do Not Track standard (https://consoledonottrack.com/)
+     * by respecting the DO_NOT_TRACK environment variable
+     */
+    isTelemetryEnabled(): boolean;
+    /**
+     * Attempts to emit events through authenticated and unauthenticated clients
+     * Falls back to caching if both attempts fail
+     */
+    private emit;
+    /**
+     * Attempts to send events through the provided API client
+     */
+    private sendEvents;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/esm/telemetry/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAOvD,qBAAa,SAAS;IAQd,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IATrC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,8DAA8D;IACvD,YAAY,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5D,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAW;IAE3B,OAAO;IAUP,MAAM,CAAC,MAAM,CACT,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,EACI,gBAA0C,EAC1C,UAAqC,GACxC,GAAE;QACC,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;KAClC,GACP,SAAS;YAOE,KAAK;IAcN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC;;;OAGG;IACU,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB3D;;;OAGG;IACI,mBAAmB,IAAI,gBAAgB;IAY9C;;;;;;OAMG;IACI,kBAAkB,IAAI,OAAO;IAUpC;;;OAGG;YACW,IAAI;IAkClB;;OAEG;YACW,UAAU;CAgB3B"}