MCP Browser Server

Instructions

Implementation Reference

• src/index.ts:601-630 (handler)

  Main handler function for the get_console_logs tool, which filters console logs by optional level, formats them with timestamps, returns as text response, and optionally clears the log storage.

  case 'get_console_logs': {
    if (!currentPage) {
      throw new Error('No browser page available. Launch a browser first.');
    }
  
    const params = GetConsoleLogsSchema.parse(args);
    
    // Filter logs by level if specified
    const filteredLogs = params.level 
      ? consoleLogs.filter(log => log.level === params.level)
      : consoleLogs;
  
    // Clear logs if requested
    if (params.clear) {
      consoleLogs = [];
    }
  
    const logText = filteredLogs.length > 0 
      ? filteredLogs.map(log => `[${log.timestamp.toISOString()}] ${log.level.toUpperCase()}: ${log.message}`).join('\n')
      : '(no console logs)';
  
    return {
      content: [
        {
          type: 'text',
          text: `Console Logs:\n${logText}`
        }
      ]
    };
  }

• src/index.ts:59-62 (schema)

  Zod schema for validating input parameters: optional level filter and clear flag.

  const GetConsoleLogsSchema = z.object({
    level: z.enum(['log', 'info', 'warn', 'error', 'debug']).optional(),
    clear: z.boolean().default(false)
  });

• src/index.ts:295-313 (registration)

  Registration of the tool in the ListTools response, providing name, description, and JSON input schema.

  {
    name: 'get_console_logs',
    description: 'Get console logs from the browser',
    inputSchema: {
      type: 'object',
      properties: {
        level: {
          type: 'string',
          enum: ['log', 'info', 'warn', 'error', 'debug'],
          description: 'Filter logs by level'
        },
        clear: {
          type: 'boolean',
          default: false,
          description: 'Clear console logs after retrieving'
        }
      }
    }
  },

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

  Global storage array for console logs captured from the browser page.

  let consoleLogs: Array<{level: string, message: string, timestamp: Date}> = [];

• src/index.ts:440-446 (helper)

  Page event listener that captures console messages and stores them in the global consoleLogs array. Set up during browser launch.

  currentPage.on('console', (msg) => {
    consoleLogs.push({
      level: msg.type(),
      message: msg.text(),
      timestamp: new Date()
    });
  });