MCP Browser Screenshot Server

Instructions

Implementation Reference

• src/index.ts:234-249 (handler)

  Handler for the browser_navigate tool. Ensures a browser page is available, navigates to the specified URL with optional waitUntil option, and returns a success message.

  case 'browser_navigate': {
    const { page } = await ensureBrowser();
    const url = args?.url as string;
    const waitUntil = (args?.waitUntil as any) || 'networkidle2';
  
    await page.goto(url, { waitUntil });
  
    return {
      content: [
        {
          type: 'text',
          text: `Navigated to ${url}`,
        },
      ],
    };
  }

• src/index.ts:110-130 (schema)

  Input schema for browser_navigate tool, requiring a URL and optionally specifying waitUntil navigation completion condition.

  inputSchema: {
    type: 'object',
    properties: {
      url: {
        type: 'string',
        description: 'URL to navigate to',
      },
      waitUntil: {
        type: 'string',
        enum: [
          'load',
          'domcontentloaded',
          'networkidle0',
          'networkidle2',
        ],
        description: 'When to consider navigation complete',
        default: 'networkidle2',
      },
    },
    required: ['url'],
  },

• src/index.ts:107-131 (registration)

  Registration of the browser_navigate tool in the ListTools response, including name, description, and input schema.

  {
    name: 'browser_navigate',
    description: 'Navigate to a URL',
    inputSchema: {
      type: 'object',
      properties: {
        url: {
          type: 'string',
          description: 'URL to navigate to',
        },
        waitUntil: {
          type: 'string',
          enum: [
            'load',
            'domcontentloaded',
            'networkidle0',
            'networkidle2',
          ],
          description: 'When to consider navigation complete',
          default: 'networkidle2',
        },
      },
      required: ['url'],
    },
  },

• src/index.ts:70-88 (helper)

  Helper function ensureBrowser() used by browser_navigate handler to launch or reuse a Puppeteer browser and page instance.

  async function ensureBrowser(): Promise<{ browser: Browser; page: Page }> {
    if (!browserState.browser || !browserState.browser.isConnected()) {
      const headless = process.env.HEADLESS !== 'false';
      browserState.browser = await puppeteer.launch({
        headless,
        args: ['--no-sandbox', '--disable-setuid-sandbox'],
      });
      browserState.page = await browserState.browser.newPage();
    }
  
    if (!browserState.page || browserState.page.isClosed()) {
      browserState.page = await browserState.browser.newPage();
    }
  
    return {
      browser: browserState.browser,
      page: browserState.page,
    };
  }