Selenium MCP Server

Instructions

Implementation Reference

• src/tools/actionTools.ts:438-456 (registration)

  Registration of the 'browser_focus_element' tool, including inline handler function that creates ActionService and calls focusElement

  server.tool('browser_focus_element', 'Focus on a specific element', { ...locatorSchema }, async ({ by, value }) => {
    try {
      const driver = stateManager.getDriver();
      const actionService = new ActionService(driver);
      await actionService.focusElement({ by, value });
      return {
        content: [{ type: 'text', text: `Focused on element` }],
      };
    } catch (e) {
      return {
        content: [
          {
            type: 'text',
            text: `Error focusing on element: ${(e as Error).message}`,
          },
        ],
      };
    }
  });

• src/tools/actionTools.ts:438-456 (handler)

  Inline handler function for the tool, which handles execution, error catching, and response formatting

  server.tool('browser_focus_element', 'Focus on a specific element', { ...locatorSchema }, async ({ by, value }) => {
    try {
      const driver = stateManager.getDriver();
      const actionService = new ActionService(driver);
      await actionService.focusElement({ by, value });
      return {
        content: [{ type: 'text', text: `Focused on element` }],
      };
    } catch (e) {
      return {
        content: [
          {
            type: 'text',
            text: `Error focusing on element: ${(e as Error).message}`,
          },
        ],
      };
    }
  });

• src/types/index.ts:29-35 (schema)

  Zod schema for locator parameters used in the tool's input schema

  export const locatorSchema = {
    by: z
      .enum(['id', 'css', 'xpath', 'name', 'tag', 'class', 'link', 'partialLink'])
      .describe('Locator strategy to find element'),
    value: z.string().describe('Value for the locator strategy'),
    timeout: z.number().optional().describe('Maximum time to wait for element in milliseconds'),
  };

• src/services/actionService.ts:97-101 (helper)

  Core implementation of focusing an element using Selenium WebDriver's executeScript to call focus() on the located element

  async focusElement(params: LocatorParams): Promise<void> {
    const locator = LocatorFactory.createLocator(params.by, params.value);
    const element = await this.driver.wait(until.elementLocated(locator), params.timeout || 15000);
    await this.driver.executeScript('arguments[0].focus();', element);
  }