16347477296

Committed 17 Jul 2025 02:10PM UTC coverage: 77.304% (-0.09%) from 77.39%

Build # 16347477296

Build Type

Pull #378

github

Committed by

web-flow

Commit Message

Merge 2f2bcf319 into fd3f2a4fd

Pull Request Pull Request #378: chore: specify the correct minimum node requirements

Run Details

496 of 685 branches covered (72.41%)

Branch coverage included in aggregate %.

2825 of 3611 relevant lines covered (78.23%)

28.48 hits per line

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

26.67

/src/tools/atlas/atlasTool.ts

import { ToolBase, ToolCategory, TelemetryToolMetadata, ToolArgs } from "../tool.js";
import { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
import logger, { LogId } from "../../common/logger.js";
import { z } from "zod";
import { ApiClientError } from "../../common/atlas/apiClientError.js";

export abstract class AtlasToolBase extends ToolBase {
    public category: ToolCategory = "atlas";

    protected verifyAllowed(): boolean {
        if (!this.config.apiClientId || !this.config.apiClientSecret) {
            return false;
        }
        return super.verifyAllowed();
    }

    protected handleError(
        error: unknown,
        args: ToolArgs<typeof this.argsShape>
    ): Promise<CallToolResult> | CallToolResult {
        if (error instanceof ApiClientError) {
            const statusCode = error.response.status;

            if (statusCode === 401) {
                return {
                    content: [
                        {
                            type: "text",
                            text: `Unable to authenticate with MongoDB Atlas, API error: ${error.message}

Hint: Your API credentials may be invalid, expired or lack permissions.
Please check your Atlas API credentials and ensure they have the appropriate permissions.
For more information on setting up API keys, visit: https://www.mongodb.com/docs/atlas/configure-api-access/`,
                        },
                    ],
                    isError: true,
                };
            }

            if (statusCode === 403) {
                return {
                    content: [
                        {
                            type: "text",
                            text: `Received a Forbidden API Error: ${error.message}

You don't have sufficient permissions to perform this action in MongoDB Atlas
Please ensure your API key has the necessary roles assigned.
For more information on Atlas API access roles, visit: https://www.mongodb.com/docs/atlas/api/service-accounts-overview/`,
                        },
                    ],
                    isError: true,
                };
            }
        }

        // For other types of errors, use the default error handling from the base class
        return super.handleError(error, args);
    }

    /**
     *
     * Resolves the tool metadata from the arguments passed to the tool
     *
     * @param args - The arguments passed to the tool
     * @returns The tool metadata
     */
    protected resolveTelemetryMetadata(
        ...args: Parameters<ToolCallback<typeof this.argsShape>>
    ): TelemetryToolMetadata {
        const toolMetadata: TelemetryToolMetadata = {};
        if (!args.length) {
            return toolMetadata;
        }

        // Create a typed parser for the exact shape we expect
        const argsShape = z.object(this.argsShape);
        const parsedResult = argsShape.safeParse(args[0]);

        if (!parsedResult.success) {
            logger.debug(
                LogId.telemetryMetadataError,
                "tool",
                `Error parsing tool arguments: ${parsedResult.error.message}`
            );
            return toolMetadata;
        }

        const data = parsedResult.data;

        // Extract projectId using type guard
        if ("projectId" in data && typeof data.projectId === "string" && data.projectId.trim() !== "") {
            toolMetadata.projectId = data.projectId;
        }

        // Extract orgId using type guard
        if ("orgId" in data && typeof data.orgId === "string" && data.orgId.trim() !== "") {
            toolMetadata.orgId = data.orgId;
        }
        return toolMetadata;
    }
}

1	import { ToolBase, ToolCategory, TelemetryToolMetadata, ToolArgs } from "../tool.js";	2✔
2	import { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
3	import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
4	import logger, { LogId } from "../../common/logger.js";	2✔
5	import { z } from "zod";	2✔
6	import { ApiClientError } from "../../common/atlas/apiClientError.js";	2✔
7
8	export abstract class AtlasToolBase extends ToolBase {	2✔
9	public category: ToolCategory = "atlas";	408✔
10
11	protected verifyAllowed(): boolean {	2✔
12	if (!this.config.apiClientId \|\| !this.config.apiClientSecret) {	408✔
13	return false;	312✔
14	}	312✔
15	return super.verifyAllowed();	96✔
16	}	408✔
17
18	protected handleError(	2✔
19	error: unknown,	×
20	args: ToolArgs<typeof this.argsShape>	×
21	): Promise<CallToolResult> \| CallToolResult {	×
22	if (error instanceof ApiClientError) {	×
23	const statusCode = error.response.status;	×
24
25	if (statusCode === 401) {	×
26	return {	×
27	content: [	×
28	{	×
29	type: "text",	×
30	text: `Unable to authenticate with MongoDB Atlas, API error: ${error.message}	×
31
32	Hint: Your API credentials may be invalid, expired or lack permissions.
33	Please check your Atlas API credentials and ensure they have the appropriate permissions.
34	For more information on setting up API keys, visit: https://www.mongodb.com/docs/atlas/configure-api-access/`,
35	},	×
36	],	×
37	isError: true,	×
38	};	×
39	}	×
40
41	if (statusCode === 403) {	×
42	return {	×
43	content: [	×
44	{	×
45	type: "text",	×
46	text: `Received a Forbidden API Error: ${error.message}	×
47
48	You don't have sufficient permissions to perform this action in MongoDB Atlas
49	Please ensure your API key has the necessary roles assigned.
50	For more information on Atlas API access roles, visit: https://www.mongodb.com/docs/atlas/api/service-accounts-overview/`,
51	},	×
52	],	×
53	isError: true,	×
54	};	×
55	}	×
56	}	×
57
58	// For other types of errors, use the default error handling from the base class
59	return super.handleError(error, args);	×
60	}	×
61
62	/**
63	*
64	* Resolves the tool metadata from the arguments passed to the tool
65	*
66	* @param args - The arguments passed to the tool
67	* @returns The tool metadata
68	*/
69	protected resolveTelemetryMetadata(	2✔
70	...args: Parameters<ToolCallback<typeof this.argsShape>>	×
71	): TelemetryToolMetadata {	×
72	const toolMetadata: TelemetryToolMetadata = {};	×
73	if (!args.length) {	×
74	return toolMetadata;	×
75	}	×
76
77	// Create a typed parser for the exact shape we expect
78	const argsShape = z.object(this.argsShape);	×
79	const parsedResult = argsShape.safeParse(args[0]);	×
80
81	if (!parsedResult.success) {	×
82	logger.debug(	×
83	LogId.telemetryMetadataError,	×
84	"tool",	×
85	`Error parsing tool arguments: ${parsedResult.error.message}`	×
86	);	×
87	return toolMetadata;	×
88	}	×
89
90	const data = parsedResult.data;	×
91
92	// Extract projectId using type guard
93	if ("projectId" in data && typeof data.projectId === "string" && data.projectId.trim() !== "") {	×
94	toolMetadata.projectId = data.projectId;	×
95	}	×
96
97	// Extract orgId using type guard
98	if ("orgId" in data && typeof data.orgId === "string" && data.orgId.trim() !== "") {	×
99	toolMetadata.orgId = data.orgId;	×
100	}	×
101	return toolMetadata;	×
102	}	×
103	}	2✔

mongodb-js / mongodb-mcp-server / 16347477296

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