feat: support --proxy-server CLI (#230)

Closes #155

Author: OrKoN

README.md

@@ -276,6 +276,10 @@ The Chrome DevTools MCP server supports the following configuration option:
   Initial viewport size for the Chromee instances started by the server. For example, `1280x720`
   - **Type:** string
 
+- **`--proxyServer`**
+  Proxy server configuration for Chrome passed as --proxy-server when launching the browser. See https://www.chromium.org/developers/design-documents/network-settings/ for details.
+  - **Type:** string
+
 <!-- END AUTO GENERATED OPTIONS -->
 
 Pass them via the `args` property in the JSON configuration. For example:

src/browser.ts

@@ -68,6 +68,7 @@ interface McpLaunchOptions {
     width: number;
     height: number;
   };
+  args?: string[];
 }
 
 export async function launch(options: McpLaunchOptions): Promise<Browser> {
@@ -90,7 +91,10 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
     });
   }
 
-  const args: LaunchOptions['args'] = ['--hide-crash-restore-bubble'];
+  const args: LaunchOptions['args'] = [
+    ...(options.args ?? []),
+    '--hide-crash-restore-bubble',
+  ];
   if (customDevTools) {
     args.push(`--custom-devtools-frontend=file://${customDevTools}`);
   }

src/cli.ts

@@ -72,6 +72,10 @@ export const cliOptions = {
       };
     },
   },
+  proxyServer: {
+    type: 'string' as const,
+    description: `Proxy server configuration for Chrome passed as --proxy-server when launching the browser. See https://www.chromium.org/developers/design-documents/network-settings/ for details.`,
+  },
 };
 
 export function parseArguments(version: string, argv = process.argv) {

src/main.ts

@@ -69,6 +69,10 @@ server.server.setRequestHandler(SetLevelRequestSchema, () => {
 
 let context: McpContext;
 async function getContext(): Promise<McpContext> {
+  const extraArgs: string[] = [];
+  if (args.proxyServer) {
+    extraArgs.push(`--proxy-server=${args.proxyServer}`);
+  }
   const browser = args.browserUrl
     ? await ensureBrowserConnected(args.browserUrl)
     : await ensureBrowserLaunched({
@@ -79,6 +83,7 @@ async function getContext(): Promise<McpContext> {
         isolated: args.isolated,
         logFile,
         viewport: args.viewport,
+        args: extraArgs,
       });
 
   if (context?.browser !== browser) {