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

59.63

/src/tools/atlas/read/listClusters.ts

import { z } from "zod";
import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
import { AtlasToolBase } from "../atlasTool.js";
import { ToolArgs, OperationType } from "../../tool.js";
import {
    PaginatedClusterDescription20240805,
    PaginatedOrgGroupView,
    Group,
    PaginatedFlexClusters20241113,
} from "../../../common/atlas/openapi.js";
import { formatCluster, formatFlexCluster } from "../../../common/atlas/cluster.js";

export class ListClustersTool extends AtlasToolBase {
    public name = "atlas-list-clusters";
    protected description = "List MongoDB Atlas clusters";
    public operationType: OperationType = "read";
    protected argsShape = {
        projectId: z.string().describe("Atlas project ID to filter clusters").optional(),
    };

    protected async execute({ projectId }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult> {
        if (!projectId) {
            const data = await this.session.apiClient.listClustersForAllProjects();

            return this.formatAllClustersTable(data);
        } else {
            const project = await this.session.apiClient.getProject({
                params: {
                    path: {
                        groupId: projectId,
                    },
                },
            });

            if (!project?.id) {
                throw new Error(`Project with ID "${projectId}" not found.`);
            }

            const data = await this.session.apiClient.listClusters({
                params: {
                    path: {
                        groupId: project.id || "",
                    },
                },
            });

            return this.formatClustersTable(project, data);
        }
    }

    private formatAllClustersTable(clusters?: PaginatedOrgGroupView): CallToolResult {
        if (!clusters?.results?.length) {
            throw new Error("No clusters found.");
        }
        const formattedClusters = clusters.results
            .map((result) => {
                return (result.clusters || []).map((cluster) => {
                    return { ...result, ...cluster, clusters: undefined };
                });
            })
            .flat();
        if (!formattedClusters.length) {
            throw new Error("No clusters found.");
        }
        const rows = formattedClusters
            .map((cluster) => {
                return `${cluster.groupName} (${cluster.groupId}) | ${cluster.name}`;
            })
            .join("\n");
        return {
            content: [
                {
                    type: "text",
                    text: `Project | Cluster Name
----------------|----------------
${rows}`,
                },
            ],
        };
    }

    private formatClustersTable(
        project: Group,
        clusters?: PaginatedClusterDescription20240805,
        flexClusters?: PaginatedFlexClusters20241113
    ): CallToolResult {
        // Check if both traditional clusters and flex clusters are absent
        if (!clusters?.results?.length && !flexClusters?.results?.length) {
            throw new Error("No clusters found.");
        }
        const formattedClusters = clusters?.results?.map((cluster) => formatCluster(cluster)) || [];
        const formattedFlexClusters = flexClusters?.results?.map((cluster) => formatFlexCluster(cluster)) || [];
        const rows = [...formattedClusters, ...formattedFlexClusters]
            .map((formattedCluster) => {
                return `${formattedCluster.name || "Unknown"} | ${formattedCluster.instanceType} | ${formattedCluster.instanceSize || "N/A"} | ${formattedCluster.state || "UNKNOWN"} | ${formattedCluster.mongoDBVersion || "N/A"} | ${formattedCluster.connectionString || "N/A"}`;
            })
            .join("\n");
        return {
            content: [
                {
                    type: "text",
                    text: `Here are your MongoDB Atlas clusters in project "${project.name}" (${project.id}):`,
                },
                {
                    type: "text",
                    text: `Cluster Name | Cluster Type | Tier | State | MongoDB Version | Connection String
----------------|----------------|----------------|----------------|----------------|----------------
${rows}`,
                },
            ],
        };
    }
}

1	import { z } from "zod";	2✔
2	import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
3	import { AtlasToolBase } from "../atlasTool.js";	2✔
4	import { ToolArgs, OperationType } from "../../tool.js";
5	import {
6	PaginatedClusterDescription20240805,
7	PaginatedOrgGroupView,
8	Group,
9	PaginatedFlexClusters20241113,
10	} from "../../../common/atlas/openapi.js";
11	import { formatCluster, formatFlexCluster } from "../../../common/atlas/cluster.js";	2✔
12
13	export class ListClustersTool extends AtlasToolBase {	2✔
14	public name = "atlas-list-clusters";	34✔
15	protected description = "List MongoDB Atlas clusters";	34✔
16	public operationType: OperationType = "read";	34✔
17	protected argsShape = {	34✔
18	projectId: z.string().describe("Atlas project ID to filter clusters").optional(),	34✔
19	};	34✔
20
21	protected async execute({ projectId }: ToolArgs<typeof this.argsShape>): Promise<CallToolResult> {	2✔
22	if (!projectId) {	1!
23	const data = await this.session.apiClient.listClustersForAllProjects();	×
24
25	return this.formatAllClustersTable(data);	×
26	} else {	1✔
27	const project = await this.session.apiClient.getProject({	1✔
28	params: {	1✔
29	path: {	1✔
30	groupId: projectId,	1✔
31	},	1✔
32	},	1✔
33	});	1✔
34
35	if (!project?.id) {	1!
36	throw new Error(`Project with ID "${projectId}" not found.`);	×
37	}	×
38
39	const data = await this.session.apiClient.listClusters({	1✔
40	params: {	1✔
41	path: {	1✔
42	groupId: project.id \|\| "",	1!
43	},	1✔
44	},	1✔
45	});	1✔
46
47	return this.formatClustersTable(project, data);	1✔
48	}	1✔
49	}	1✔
50
51	private formatAllClustersTable(clusters?: PaginatedOrgGroupView): CallToolResult {	2✔
52	if (!clusters?.results?.length) {	×
53	throw new Error("No clusters found.");	×
54	}	×
55	const formattedClusters = clusters.results	×
56	.map((result) => {	×
57	return (result.clusters \|\| []).map((cluster) => {	×
58	return { ...result, ...cluster, clusters: undefined };	×
59	});	×
60	})	×
61	.flat();	×
62	if (!formattedClusters.length) {	×
63	throw new Error("No clusters found.");	×
64	}	×
65	const rows = formattedClusters	×
66	.map((cluster) => {	×
67	return `${cluster.groupName} (${cluster.groupId}) \| ${cluster.name}`;	×
68	})	×
69	.join("\n");	×
70	return {	×
71	content: [	×
72	{	×
73	type: "text",	×
74	text: `Project \| Cluster Name	×
75	----------------\|----------------
76	${rows}`,	×
77	},	×
78	],	×
79	};	×
80	}	×
81
82	private formatClustersTable(	2✔
83	project: Group,	1✔
84	clusters?: PaginatedClusterDescription20240805,	1✔
85	flexClusters?: PaginatedFlexClusters20241113	1✔
86	): CallToolResult {	1✔
87	// Check if both traditional clusters and flex clusters are absent
88	if (!clusters?.results?.length && !flexClusters?.results?.length) {	1!
89	throw new Error("No clusters found.");	×
90	}	×
91	const formattedClusters = clusters?.results?.map((cluster) => formatCluster(cluster)) \|\| [];	1!
92	const formattedFlexClusters = flexClusters?.results?.map((cluster) => formatFlexCluster(cluster)) \|\| [];	1!
93	const rows = [...formattedClusters, ...formattedFlexClusters]	1✔
94	.map((formattedCluster) => {	1✔
95	return `${formattedCluster.name \|\| "Unknown"} \| ${formattedCluster.instanceType} \| ${formattedCluster.instanceSize \|\| "N/A"} \| ${formattedCluster.state \|\| "UNKNOWN"} \| ${formattedCluster.mongoDBVersion \|\| "N/A"} \| ${formattedCluster.connectionString \|\| "N/A"}`;	1!
96	})	1✔
97	.join("\n");	1✔
98	return {	1✔
99	content: [	1✔
100	{	1✔
101	type: "text",	1✔
102	text: `Here are your MongoDB Atlas clusters in project "${project.name}" (${project.id}):`,	1✔
103	},	1✔
104	{	1✔
105	type: "text",	1✔
106	text: `Cluster Name \| Cluster Type \| Tier \| State \| MongoDB Version \| Connection String	1✔
107	----------------\|----------------\|----------------\|----------------\|----------------\|----------------
108	${rows}`,	1✔
109	},	1✔
110	],	1✔
111	};	1✔
112	}	1✔
113	}	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