PlayMCP Browser Automation Server

Instructions

Implementation Reference

• src/controllers/playwright.ts:73-85 (handler)

  Core handler function that performs the browser navigation using Playwright's page.goto() method.
  async navigate(url: string): Promise<void> { try { if (!this.isInitialized()) { throw new Error('Browser not initialized'); } this.log('Navigating to', url); await this.state.page?.goto(url); this.log('Navigation complete'); } catch (error: any) { console.error('Navigation error:', error); throw new BrowserError('Failed to navigate', 'Check if the URL is valid and accessible'); } }
• src/server.ts:586-597 (handler)

  MCP tool dispatch handler in callTool that validates input and invokes the controller's navigate method.
  case 'navigate': { if (!args.url || typeof args.url !== 'string') { return { content: [{ type: "text", text: "URL is required" }], isError: true }; } await playwrightController.navigate(args.url); return { content: [{ type: "text", text: "Navigation successful" }] }; }
• src/server.ts:19-29 (schema)

  Tool schema definition including name, description, and input schema requiring a 'url' string.
  const NAVIGATE_TOOL: Tool = { name: "navigate", description: "Navigate to a URL", inputSchema: { type: "object", properties: { url: { type: "string" } }, required: ["url"] } };
• src/server.ts:516-516 (registration)

  Registration of the navigate tool in the tools object passed to MCP server capabilities.
  navigate: NAVIGATE_TOOL,