refactor: Update atlas local error handling

src/server.ts

@@ -231,29 +231,37 @@ export class Server {
  // This will fail on unsupported platforms
  const { Client: AtlasLocalClient } = await import("@mongodb-js-preview/atlas-local");
 
- // Connect to Atlas Local client
- // This will fail if docker is not running
- const client = AtlasLocalClient.connect();
-
- // Set Atlas Local client
- this.session.atlasLocalClient = client;
-
- // Register Atlas Local tools
- for (const toolConstructor of AtlasLocalTools) {
- const tool = new toolConstructor({
- session: this.session,
- config: this.userConfig,
- telemetry: this.telemetry,
- elicitation: this.elicitation,
- });
- if (tool.register(this)) {
- this.tools.push(tool);
+ try {
+ // Connect to Atlas Local client
+ // This will fail if docker is not running
+ const client = AtlasLocalClient.connect();
+
+ // Set Atlas Local client
+ this.session.atlasLocalClient = client;
+
+ // Register Atlas Local tools
+ for (const toolConstructor of AtlasLocalTools) {
+ const tool = new toolConstructor({
+ session: this.session,
+ config: this.userConfig,
+ telemetry: this.telemetry,
+ elicitation: this.elicitation,
+ });
+ if (tool.register(this)) {
+ this.tools.push(tool);
+ }
  }
+ } catch (dockerError) {
+ console.warn(
+ "Failed to connect to Atlas Local client (Docker not available or not running), atlas-local tools will be disabled (error: ",
+ dockerError,
+ ")"
+ );
  }
- } catch (error) {
+ } catch (importError) {
  console.warn(
- "Failed to initialize Atlas Local client, atlas-local tools will be disabled (error: ",
- error,
+ "Failed to import Atlas Local client (platform not supported), atlas-local tools will be disabled (error: ",
+ importError,
  ")"
  );
  }

src/tools/atlasLocal/atlasLocalTool.ts

@@ -56,6 +56,25 @@ please log a ticket here: https://github.com/mongodb-js/mongodb-mcp-server/issue
  ): Promise<CallToolResult> | CallToolResult {
  // Error Handling for expected Atlas Local errors go here
  const errorMessage = error instanceof Error ? error.message : String(error);
+
+ // Check if Docker daemon is not running
+ if (
+ errorMessage.includes("Cannot connect to the Docker daemon") ||
+ errorMessage.includes("Is the docker daemon running") ||
+ errorMessage.includes("connect ENOENT") ||
+ errorMessage.includes("ECONNREFUSED")
+ ) {
+ return {
+ content: [
+ {
+ type: "text",
+ text: "Docker is not running. Please start Docker and try again. Atlas Local tools require Docker to be running.",
+ },
+ ],
+ isError: true,
+ };
+ }
+
  if (errorMessage.includes("No such container")) {
  const deploymentName =
  "deploymentName" in args ? (args.deploymentName as string) : "the specified deployment";