PlayMCP Browser Automation Server

Instructions

Implementation Reference

• src/controllers/playwright.ts:115-135 (handler)

  The core handler function implementing the click tool logic using Playwright's page.click for the given selector.
  async click(selector?: string): Promise<void> { try { if (!this.isInitialized() || !this.state.page) { throw new Error('Browser not initialized'); } if (selector) { this.log('Clicking element', selector); await this.state.page.click(selector); } else { this.log('Clicking at position', this.currentMousePosition); await this.state.page.mouse.click(this.currentMousePosition.x, this.currentMousePosition.y); } this.log('Click complete'); } catch (error: any) { console.error('Click error:', error); throw new BrowserError( 'Failed to click', selector ? 'Check if the element exists and is visible' : 'Check if mouse position is valid' ); } }
• src/server.ts:44-54 (schema)

  Schema definition for the 'click' tool, specifying name, description, and required 'selector' input.
  const CLICK_TOOL: Tool = { name: "click", description: "Click an element", inputSchema: { type: "object", properties: { selector: { type: "string" } }, required: ["selector"] } };
• src/server.ts:612-623 (handler)

  MCP callTool handler case for 'click' that validates the selector argument and invokes the Playwright controller.
  case 'click': { if (!args.selector) { return { content: [{ type: "text", text: "Selector is required" }], isError: true }; } await playwrightController.click(args.selector as string); return { content: [{ type: "text", text: "Click successful" }] }; }
• src/server.ts:555-565 (registration)

  Server initialization that registers the tools object (including 'click' tool) in MCP capabilities.
  const server = new Server( { name: "playmcp-browser", version: "1.0.0", }, { capabilities: { tools, }, } );
• src/server.ts:518-518 (registration)

  Specific registration of the 'click' tool in the tools dictionary used for MCP server capabilities.
  click: CLICK_TOOL,