Browser CDP MCP Server

Implementation Reference

• server.js:85-88 (handler)

  Inline handler function for the 'get_url' tool. It retrieves the current browser page URL using Playwright's page.url() method and returns it as text content.

  server.tool("get_url", {}, async () => {
    const { page } = await ensureBrowser();
    return { content: [{ type: "text", text: page.url() }] };
  });

• server.js:85-88 (registration)

  Registration of the 'get_url' tool using server.tool(), with empty schema and inline handler.

  server.tool("get_url", {}, async () => {
    const { page } = await ensureBrowser();
    return { content: [{ type: "text", text: page.url() }] };
  });

• server.js:16-26 (helper)

  Helper function ensureBrowser() that launches Chromium browser if not already running and provides access to page object used by get_url handler.

  async function ensureBrowser() {
    if (!browser) {
      browser = await chromium.launch({
        headless: false,
        args: ["--disable-web-security", "--allow-running-insecure-content"],
      });
      page = await browser.newPage();
      cdp = await page.context().newCDPSession(page);
    }
    return { browser, page, cdp };
  }