chore: Enable proxy for OIDC and MongoDB connections MCP-88 (#405)

Author: kmruiz

README.md

@@ -22,6 +22,7 @@ A Model Context Protocol server for interacting with MongoDB Databases and Mongo
     - [Environment Variables](#environment-variables)
     - [Command-Line Arguments](#command-line-arguments)
     - [MCP Client Configuration](#mcp-configuration-file-examples)
+    - [Proxy Support](#proxy-support)
 - [🤝 Contributing](#contributing)
 
 <a name="getting-started"></a>
@@ -574,6 +575,13 @@ npx -y mongodb-mcp-server@latest --apiClientId="your-atlas-service-accounts-clie
 }
 ```
 
+### Proxy Support
+
+The MCP Server will detect typical PROXY environment variables and use them for
+connecting to the Atlas API, your MongoDB Cluster, or any other external calls
+to third-party services like OID Providers. The behaviour is the same as what
+`mongosh` does, so the same settings will work in the MCP Server.
+
 ## 🤝Contributing
 
 Interested in contributing? Great! Please check our [Contributing Guide](CONTRIBUTING.md) for guidelines on code contributions, standards, adding new tools, and troubleshooting information.

src/common/session.ts

@@ -113,6 +113,8 @@ export class Session extends EventEmitter<{
                 w: connectOptions.writeConcern,
             },
             timeoutMS: connectOptions.timeoutMS,
+            proxy: { useEnvironmentVariableProxies: true },
+            applyProxyToOIDC: true,
         });
     }
 }

tests/unit/common/session.test.ts

@@ -56,5 +56,17 @@ describe("Session", () => {
                 }
             });
         }
+
+        it("should configure the proxy to use environment variables", async () => {
+            await session.connectToMongoDB("mongodb://localhost", config.connectOptions);
+            expect(session.serviceProvider).toBeDefined();
+
+            const connectMock = MockNodeDriverServiceProvider.connect;
+            expect(connectMock).toHaveBeenCalledOnce();
+
+            const connectionConfig = connectMock.mock.calls[0]?.[1];
+            expect(connectionConfig?.proxy).toEqual({ useEnvironmentVariableProxies: true });
+            expect(connectionConfig?.applyProxyToOIDC).toEqual(true);
+        });
     });
 });