17214463920

Committed 25 Aug 2025 04:18PM UTC coverage: 81.821%. First build

Build # 17214463920

Build Type

Pull #475

github

Committed by

web-flow

Commit Message

Merge 1e376c2b8 into 46a93cca5

Pull Request Pull Request #475: chore: add more information when there is a failure connecting MCP-92

Run Details

908 of 1137 branches covered (79.86%)

Branch coverage included in aggregate %.

24 of 25 new or added lines in 3 files covered. (96.0%)

4367 of 5310 relevant lines covered (82.24%)

143.51 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

96.25

/src/resources/common/debug.ts

import { ReactiveResource } from "../resource.js";
import type { Telemetry } from "../../telemetry/telemetry.js";
import type { Session, UserConfig } from "../../lib.js";
import type { AtlasClusterConnectionInfo, ConnectionStateErrored } from "../../common/connectionManager.js";

type ConnectionStateDebuggingInformation = {
    readonly tag: "connected" | "connecting" | "disconnected" | "errored";
    readonly connectionStringAuthType?: "scram" | "ldap" | "kerberos" | "oidc-auth-flow" | "oidc-device-flow" | "x.509";
    readonly errorReason?: string;
    readonly connectedAtlasCluster?: AtlasClusterConnectionInfo;
};

export class DebugResource extends ReactiveResource<
    ConnectionStateDebuggingInformation,
    readonly ["connect", "disconnect", "close", "connection-error"]
> {
    constructor(session: Session, config: UserConfig, telemetry: Telemetry) {
        super({
            resourceConfiguration: {
                name: "debug-mongodb",
                uri: "debug://mongodb",
                config: {
                    description:
                        "Debugging information for MongoDB connectivity issues. Tracks the last connectivity attempt and error information.",
                },
            },
            options: {
                initial: { tag: "disconnected" },
                events: ["connect", "disconnect", "close", "connection-error"],
            },
            session,
            config,
            telemetry,
        });
    }
    reduce(
        eventName: "connect" | "disconnect" | "close" | "connection-error",
        event: ConnectionStateErrored | undefined
    ): ConnectionStateDebuggingInformation {
        switch (eventName) {
            case "connect":
                return { tag: "connected" };
            case "connection-error": {
                return {
                    tag: "errored",
                    connectionStringAuthType: event?.connectionStringAuthType,
                    connectedAtlasCluster: event?.connectedAtlasCluster,
                    errorReason:
                        event?.errorReason ??
                        "Could not find a reason. This might be a bug in the MCP Server. Please open an issue in https://github.com/mongodb-js/mongodb-mcp-server.",
                };
            }
            case "disconnect":
            case "close":
                return { tag: "disconnected" };
        }
    }

    toOutput(): string {
        let result = "";

        switch (this.current.tag) {
            case "connected":
                result += "The user is connected to the MongoDB cluster.";
                break;
            case "errored":
                result += `The user is not connected to a MongoDB cluster because of an error.\n`;
                if (this.current.connectedAtlasCluster) {
                    result += `Attempted connecting to Atlas Cluster "${this.current.connectedAtlasCluster.clusterName}" in project with id "${this.current.connectedAtlasCluster.projectId}".\n`;
                }

                result += `The inferred authentication mechanism is "${this.current.connectionStringAuthType ?? "could-not-infer"}".\n`;
                result += `<error>${this.current.errorReason}</error>`;
                break;
            case "connecting":
            case "disconnected":
                result += "The user is not connected to a MongoDB cluster.";
                break;
        }

        return result;
    }
}

1	import { ReactiveResource } from "../resource.js";	4✔
2	import type { Telemetry } from "../../telemetry/telemetry.js";
3	import type { Session, UserConfig } from "../../lib.js";
4	import type { AtlasClusterConnectionInfo, ConnectionStateErrored } from "../../common/connectionManager.js";
5
6	type ConnectionStateDebuggingInformation = {
7	readonly tag: "connected" \| "connecting" \| "disconnected" \| "errored";
8	readonly connectionStringAuthType?: "scram" \| "ldap" \| "kerberos" \| "oidc-auth-flow" \| "oidc-device-flow" \| "x.509";
9	readonly errorReason?: string;
10	readonly connectedAtlasCluster?: AtlasClusterConnectionInfo;
11	};
12
13	export class DebugResource extends ReactiveResource<	4✔
14	ConnectionStateDebuggingInformation,
15	readonly ["connect", "disconnect", "close", "connection-error"]
16	> {	4✔
17	constructor(session: Session, config: UserConfig, telemetry: Telemetry) {	4✔
18	super({	188✔
19	resourceConfiguration: {	188✔
20	name: "debug-mongodb",	188✔
21	uri: "debug://mongodb",	188✔
22	config: {	188✔
23	description:	188✔
24	"Debugging information for MongoDB connectivity issues. Tracks the last connectivity attempt and error information.",	188✔
25	},	188✔
26	},	188✔
27	options: {	188✔
28	initial: { tag: "disconnected" },	188✔
29	events: ["connect", "disconnect", "close", "connection-error"],	188✔
30	},	188✔
31	session,	188✔
32	config,	188✔
33	telemetry,	188✔
34	});	188✔
35	}	188✔
36	reduce(	4✔
37	eventName: "connect" \| "disconnect" \| "close" \| "connection-error",	1,926✔
38	event: ConnectionStateErrored \| undefined	1,926✔
39	): ConnectionStateDebuggingInformation {	1,926✔
40	switch (eventName) {	1,926✔
41	case "connect":	1,926✔
42	return { tag: "connected" };	796✔
43	case "connection-error": {	1,926✔
44	return {	86✔
45	tag: "errored",	86✔
46	connectionStringAuthType: event?.connectionStringAuthType,	86✔
47	connectedAtlasCluster: event?.connectedAtlasCluster,	86✔
48	errorReason:	86✔
49	event?.errorReason ??	86!
NEW 50	"Could not find a reason. This might be a bug in the MCP Server. Please open an issue in https://github.com/mongodb-js/mongodb-mcp-server.",	×
51	};	86✔
52	}	86✔
53	case "disconnect":	1,926✔
54	case "close":	1,926✔
55	return { tag: "disconnected" };	1,044✔
56	}	1,926✔
57	}	1,926✔
58
59	toOutput(): string {	4✔
60	let result = "";	24✔
61
62	switch (this.current.tag) {	24✔
63	case "connected":	24✔
64	result += "The user is connected to the MongoDB cluster.";	4✔
65	break;	4✔
66	case "errored":	24✔
67	result += `The user is not connected to a MongoDB cluster because of an error.\n`;	12✔
68	if (this.current.connectedAtlasCluster) {	12✔
69	result += `Attempted connecting to Atlas Cluster "${this.current.connectedAtlasCluster.clusterName}" in project with id "${this.current.connectedAtlasCluster.projectId}".\n`;	4✔
70	}	4✔
71
72	result += `The inferred authentication mechanism is "${this.current.connectionStringAuthType ?? "could-not-infer"}".\n`;	12✔
73	result += `<error>${this.current.errorReason}</error>`;	12✔
74	break;	12✔
75	case "connecting":	24!
76	case "disconnected":	24✔
77	result += "The user is not connected to a MongoDB cluster.";	8✔
78	break;	8✔
79	}	24✔
80
81	return result;	24✔
82	}	24✔
83	}	4✔

mongodb-js / mongodb-mcp-server / 17214463920

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous