Browserless MCP Server

Instructions

Implementation Reference

• src/client.ts:185-196 (handler)

  Core handler implementation that performs HTTP POST to Browserless '/performance' endpoint to execute the Lighthouse performance audit.

  async runPerformanceAudit(request: PerformanceRequest): Promise<BrowserlessResponse<PerformanceResponse>> {
    try {
      const response: AxiosResponse<PerformanceResponse> = await this.httpClient.post('/performance', request);
  
      return {
        success: true,
        data: response.data,
      };
    } catch (error) {
      return this.handleError(error);
    }
  }

• src/index.ts:437-456 (handler)

  MCP server-side tool handler for 'run_performance_audit' that delegates to BrowserlessClient and formats the MCP response.

  case 'run_performance_audit': {
    if (!args) throw new Error('Arguments are required');
    const result = await this.client!.runPerformanceAudit(args as any);
    if (result.success && result.data) {
      return {
        content: [
          {
            type: 'text',
            text: 'Performance audit completed successfully.',
          },
          {
            type: 'text',
            text: JSON.stringify(result.data, null, 2),
          },
        ],
      };
    } else {
      throw new Error(result.error || 'Failed to run performance audit');
    }
  }

• src/index.ts:172-189 (schema)

  Input schema definition for the 'run_performance_audit' tool, including required 'url' and optional 'config'.

  {
    name: 'run_performance_audit',
    description: 'Run Lighthouse performance audit',
    inputSchema: {
      type: 'object',
      properties: {
        url: { type: 'string' },
        config: {
          type: 'object',
          properties: {
            extends: { type: 'string' },
            settings: { type: 'object' },
          },
        },
      },
      required: ['url'],
    },
  },

• src/types.ts:200-208 (schema)

  Zod schema and TypeScript type definition for PerformanceRequest used in the client implementation.

  export const PerformanceRequestSchema = z.object({
    url: z.string(),
    config: z.object({
      extends: z.string().optional(),
      settings: z.record(z.any()).optional(),
    }).optional(),
  });
  
  export type PerformanceRequest = z.infer<typeof PerformanceRequestSchema>;