Lighthouse Puppeteer Integration

Example Use Cases

• 1

  Run full Lighthouse audits and produce HTML/JSON/PDF reports for performance, accessibility, SEO and PWA validation.

• 2

  Quick access to key performance metrics (e.g., LCP, FCP, CLS) without fetching full reports for lightweight monitoring or comparison.

• 3

  Automate browser interactions with Puppeteer while integrating Lighthouse checks into end-to-end QA and auditing workflows.

Description

This MCP server adds Lighthouse capabilities to an existing Puppeteer MCP environment, exposing tools to run full audits, fetch key metrics, and output reports (HTML/JSON/PDF). It provides two primary tools — lighthouse_analyze for complete audits and lighthouse_get_metrics for key metrics — while preserving all standard Puppeteer interactions. Deployment options include Docker and NPX, and the project is distributed under the MIT License. This enables agents to automate site auditing, accessibility checks, and performance monitoring as part of browser-driven workflows.