PlayMCP Browser Automation Server

Instructions

Implementation Reference

• src/controllers/playwright.ts:651-664 (handler)

  The core handler function in PlaywrightController that locates the select element by selector and calls selectOption(values) to select the specified options. Includes logging, error handling, and browser state checks.

  async selectOption(selector: string, values: string[]): Promise<void> {
    try {
      if (!this.isInitialized() || !this.state.page) {
        throw new Error('Browser not initialized');
      }
      this.log('Selecting options', { selector, values });
      const locator = this.state.page.locator(selector);
      await locator.selectOption(values);
      this.log('Select option complete');
    } catch (error: any) {
      console.error('Select option error:', error);
      throw new BrowserError('Failed to select option', 'Check if the selector exists and values are valid');
    }
  }

• src/server.ts:295-310 (schema)

  The Tool object definition including name, description, and inputSchema for validating selector (string) and values (array of strings).

  const SELECT_OPTION_TOOL: Tool = {
    name: "selectOption",
    description: "Select option(s) in a dropdown or select element",
    inputSchema: {
      type: "object",
      properties: {
        selector: { type: "string" },
        values: { 
          type: "array",
          items: { type: "string" },
          description: "Array of values to select"
        }
      },
      required: ["selector", "values"]
    }
  };

• src/server.ts:514-553 (registration)

  The tools object where SELECT_OPTION_TOOL is registered under the 'selectOption' key, which is then passed to the MCP Server capabilities.

  const tools = {
    openBrowser: OPEN_BROWSER_TOOL,
    navigate: NAVIGATE_TOOL,
    type: TYPE_TOOL,
    click: CLICK_TOOL,
    moveMouse: MOVE_MOUSE_TOOL,
    scroll: SCROLL_TOOL,
    screenshot: SCREENSHOT_TOOL,
    getPageSource: GET_PAGE_SOURCE_TOOL,
    getPageText: GET_PAGE_TEXT_TOOL,
    getPageTitle: GET_PAGE_TITLE_TOOL,
    getPageUrl: GET_PAGE_URL_TOOL,
    getScripts: GET_SCRIPTS_TOOL,
    getStylesheets: GET_STYLESHEETS_TOOL,
    getMetaTags: GET_META_TAGS_TOOL,
    getLinks: GET_LINKS_TOOL,
    getImages: GET_IMAGES_TOOL,
    getForms: GET_FORMS_TOOL,
    getElementContent: GET_ELEMENT_CONTENT_TOOL,
    getElementHierarchy: GET_ELEMENT_HIERARCHY_TOOL,
    executeJavaScript: EXECUTE_JAVASCRIPT_TOOL,
    goForward: GO_FORWARD_TOOL,
    hover: HOVER_TOOL,
    dragAndDrop: DRAG_AND_DROP_TOOL,
    selectOption: SELECT_OPTION_TOOL,
    pressKey: PRESS_KEY_TOOL,
    waitForText: WAIT_FOR_TEXT_TOOL,
    waitForSelector: WAIT_FOR_SELECTOR_TOOL,
    resize: RESIZE_TOOL,
    handleDialog: HANDLE_DIALOG_TOOL,
    getConsoleMessages: GET_CONSOLE_MESSAGES_TOOL,
    getNetworkRequests: GET_NETWORK_REQUESTS_TOOL,
    uploadFiles: UPLOAD_FILES_TOOL,
    evaluateWithReturn: EVALUATE_WITH_RETURN_TOOL,
    takeScreenshot: TAKE_SCREENSHOT_TOOL,
    mouseMove: MOUSE_MOVE_TOOL,
    mouseClick: MOUSE_CLICK_TOOL,
    mouseDrag: MOUSE_DRAG_TOOL,
    closeBrowser: CLOSE_BROWSER_TOOL
  };

• src/server.ts:821-832 (registration)

  The dispatch case in callTool handler that validates args and invokes the playwrightController.selectOption method.

  case 'selectOption': {
    if (!args.selector || !args.values) {
      return {
        content: [{ type: "text", text: "Selector and values are required" }],
        isError: true
      };
    }
    await playwrightController.selectOption(args.selector as string, args.values as string[]);
    return {
      content: [{ type: "text", text: "Option selected successfully" }]
    };
  }