feat: add --profile-directory option to specify Chrome profile

Added a new CLI option to allow users to specify which Chrome profile
to use when launching the browser.

Changes:
- Added --profile-directory CLI argument
- Updated BrowserOptions interface
- Connected CLI arg to Chrome launch flag
- Added documentation in README.md

Author: Yasindu20

README.md

@@ -443,6 +443,10 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** boolean
   - **Default:** `true`
 
+- **`--profileDirectory`/ `--profile-directory`, `-profile-dir`**
+  Specify which Chrome profile to use by its directory name (e.g., "Profile 1", "Default"). Only works with --autoConnect or when launching Chrome.
+  - **Type:** string
+
 <!-- END AUTO GENERATED OPTIONS -->
 
 Pass them via the `args` property in the JSON configuration. For example:

src/browser.ts

@@ -144,6 +144,7 @@ interface McpLaunchOptions {
   };
   args?: string[];
   devtools: boolean;
+  profileDirectory?: string;
 }
 
 export async function launch(options: McpLaunchOptions): Promise<Browser> {
@@ -170,6 +171,9 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
     ...(options.args ?? []),
     '--hide-crash-restore-bubble',
   ];
+  if (options.profileDirectory) {
+    args.push(`--profile-directory=${options.profileDirectory}`);
+  }
   if (headless) {
     args.push('--screen-info={3840x2160}');
   }

src/cli.ts

@@ -183,6 +183,13 @@ export const cliOptions = {
     default: true,
     describe: 'Set to false to exclude tools related to network.',
   },
+  profileDirectory: {
+    type: 'string',
+    description:
+      'Specify which Chrome profile to use by its directory name (e.g., "Profile 1", "Default"). Only works with --autoConnect or when launching Chrome.',
+    alias: 'profile-dir',
+    conflicts: ['browserUrl', 'wsEndpoint'],
+  },
 } satisfies Record<string, YargsOptions>;
 
 export function parseArguments(version: string, argv = process.argv) {
@@ -247,6 +254,14 @@ export function parseArguments(version: string, argv = process.argv) {
         '$0 --auto-connect --channel=canary',
         'Connect to a canary Chrome instance (Chrome 145+) running instead of launching a new instance',
       ],
+      [
+        '$0 --auto-connect --profile-directory="Profile 1"',
+        'Connect to Chrome using a specific profile (requires Chrome 145+)',
+      ],
+      [
+        '$0 --channel=stable --profile-directory="Work Profile"',
+        'Launch stable Chrome with a specific profile',
+      ],
     ]);
 
   return yargsInstance

src/main.ts

@@ -81,6 +81,7 @@ async function getContext(): Promise<McpContext> {
           args: extraArgs,
           acceptInsecureCerts: args.acceptInsecureCerts,
           devtools,
+          profileDirectory: args.profileDirectory,
         });
 
   if (context?.browser !== browser) {