Lighthouse Mcp
@priyankark
Allows AI assistants such as Amp/Cline/Cursor/Claude Code/Codex/GitHub Copilot to use Google's lighthouse tool to measure perf metrics for your webpage. You can then run an agentic loop and get the assistants to optimize those metrics!
Overview
What is Lighthouse Mcp?
Lighthouse Mcp is an MCP server that wraps Google’s Lighthouse tool to measure performance, accessibility, SEO, and other web page metrics. It is designed for developers and site owners who want automated audits through MCP‑compatible clients like Claude.
How to use Lighthouse Mcp?
Install via the MCP Registry, npx lighthouse-mcp, npm install -g lighthouse-mcp, or local clone and build. Then add a lighthouse entry to your MCP settings file with the appropriate command and args. Once configured, ask Claude or another MCP client to audit a URL.
Key features of Lighthouse Mcp
- Run comprehensive Lighthouse audits on any URL
- Get performance scores and metrics
- Configure device emulation (mobile/desktop)
- Control network throttling on/off
- Select specific audit categories (performance, accessibility, best‑practices, SEO, PWA)
Use cases of Lighthouse Mcp
- Audit a web page’s performance score before a release
- Compare mobile vs desktop performance for a site
- Check accessibility and SEO compliance automatically
- Integrate Lighthouse audits into an AI‑assisted development workflow
- Test how throttling affects page load metrics
FAQ from Lighthouse Mcp
What are the runtime requirements?
Node.js 16 or later and a Chrome/Chromium browser installed on the system.
How do I install Lighthouse Mcp?
You can install via the MCP Registry, run directly with npx lighthouse-mcp, install globally with npm install -g lighthouse-mcp, or clone the repo and build locally.
What parameters does the run_audit tool accept?
It requires a url, and optionally accepts categories (array from "performance", "accessibility", "best-practices", "seo", "pwa"), device ("mobile" or "desktop", default "mobile"), and throttling (boolean, default true).
Can I get only the performance score without a full audit?
Yes, the get_performance_score tool returns just the performance score for a URL, with an optional device parameter.
Does Lighthouse Mcp work with Claude Desktop?
Yes, it is designed for use with MCP clients including Claude Desktop; example usage shows asking Claude for a performance score.
