MCP Lighthouse Audit

An MCP server that provides detailed Lighthouse audits for web pages. Unlike basic tools that only return scores, this server returns the specific elements that fail each audit with actionable suggestions.

Features

• Detailed Lighthouse audits with scores and specific failing elements
• Works with localhost and public URLs
• Desktop and mobile presets
• Category filtering (performance, accessibility, seo, best-practices)
• Clear output format with HTML snippets and selectors

Installation

# Clone and build
cd ~/Dev/mcp-lighthouse-audit
pnpm install
pnpm build

Add to Claude Code

claude mcp add lighthouse-audit node ~/Dev/mcp-lighthouse-audit/dist/index.js

Or add manually to ~/.claude/settings.json:

{
  "mcpServers": {
    "lighthouse-audit": {
      "command": "node",
      "args": ["/Users/<username>/Dev/mcp-lighthouse-audit/dist/index.js"]
    }
  }
}

Usage

Once installed, you can use the audit_page tool in Claude:

Basic audit

Audit http://localhost:4343/cottages

With specific categories

Audit http://localhost:4343 for accessibility only

Mobile preset

Audit https://example.com with mobile preset

Tool: audit_page

Input

Parameter	Type	Required	Description
url	string	Yes	URL to audit (localhost or public)
categories	string[]	No	Categories to audit: performance, accessibility, best-practices, seo
preset	string	No	Device preset: desktop (default) or mobile

Output

Returns a formatted report with:

• Scores for each category (0-100)
• Summary of passed/failed audits
• Detailed list of failed audits grouped by category
• For each failed audit:
  • ID and title
  • Score
  • Description
  • Affected elements (HTML snippets, CSS selectors, URLs)

Requirements

• Node.js >= 18
• Chrome or Chromium installed on the system

License

MIT