Playwright MCP Server

Instructions

Implementation Reference

• src/toolsHandler.ts:63-88 (handler)

  The core handler logic for the 'playwright_navigate' tool. It navigates the Playwright page to the specified URL with optional timeout and waitUntil options, returning success or error message.

  case "playwright_navigate":
    try {
      await page!.goto(args.url, {
        timeout: args.timeout || 30000,
        waitUntil: args.waitUntil || "load"
      });
      return {
        toolResult: {
          content: [{
            type: "text",
            text: `Navigated to ${args.url} with ${args.waitUntil || "load"} wait`,
          }],
          isError: false,
        },
      };
    } catch (error) {
      return {
        toolResult: {
          content: [{
            type: "text",
            text: `Navigation failed: ${(error as Error).message}`,
          }],
          isError: true,
        },
      };
    }

• src/tools.ts:5-15 (schema)

  The tool schema definition for 'playwright_navigate', including name, description, and input schema requiring a 'url' string.

  {
    name: "playwright_navigate",
    description: "Navigate to a URL",
    inputSchema: {
      type: "object",
      properties: {
        url: { type: "string" },
      },
      required: ["url"],
    },
  },

• src/requestHandler.ts:64-67 (registration)

  Registration of the MCP CallTool request handler, which routes tool calls (including 'playwright_navigate') to the handleToolCall function in toolsHandler.ts.

  // Call tool handler
  server.setRequestHandler(CallToolRequestSchema, async (request) =>
    handleToolCall(request.params.name, request.params.arguments ?? {}, server)
  );

• src/requestHandler.ts:60-62 (registration)

  Registration of the MCP ListTools request handler, which provides the list of available tools including 'playwright_navigate'.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: tools,
  }));

• src/toolsHandler.ts:15-32 (helper)

  Helper function to ensure the Playwright browser and page are launched, used by browser-requiring tools like 'playwright_navigate'.

  async function ensureBrowser() {
    if (!browser) {
      browser = await chromium.launch({ headless: false });
      const context = await browser.newContext({
        viewport: { width: 1920, height: 1080 },
        deviceScaleFactor: 1,
      });
  
      page = await context.newPage();
  
      page.on("console", (msg) => {
        const logEntry = `[${msg.type()}] ${msg.text()}`;
        consoleLogs.push(logEntry);
        // Note: server.notification is assumed to be passed in from the main server
      });
    }
    return page!;
  }