lighthouse-mcp

Integrations

  • Integrates with Google's Lighthouse tool to provide web performance analysis and auditing capabilities.

  • Wraps around Google's Lighthouse tool to run comprehensive performance audits on web pages, providing performance scores, metrics, device emulation, network throttling control, and specific audit categories (performance, accessibility, best-practices, seo, pwa).

  • Enables auditing of Progressive Web App (PWA) metrics as one of the available audit categories when running Lighthouse tests.

Lighthouse MCP Server

An MCP server that wraps around Google's Lighthouse tool to help measure various performance metrics for web pages.

Features

  • Run comprehensive Lighthouse audits on any URL
  • Get performance scores and metrics
  • Configure device emulation (mobile/desktop)
  • Control network throttling
  • Select specific audit categories

Installation

You can run the tool directly using npx without installation:

npx lighthouse-mcp

Option 2: Global Installation

Install the package globally:

npm install -g lighthouse-mcp

Then run it:

lighthouse-mcp

Option 3: Local Development

  1. Clone this repository
  2. Install dependencies:
    npm install
  3. Build the project:
    npm run build
  4. Run the server:
    npm start

MCP Configuration

When installed via npm (global or npx)

Add the following to your MCP settings configuration file:

{ "mcpServers": { "lighthouse": { "command": "npx", "args": ["lighthouse-mcp"], "disabled": false, "autoApprove": [] } } }

When using local development version

Add the following to your MCP settings configuration file:

{ "mcpServers": { "lighthouse": { "command": "node", "args": ["/absolute/path/to/lighthouse-mcp/build/index.js"], "disabled": false, "autoApprove": [] } } }

Replace /absolute/path/to/lighthouse-mcp with the actual path to this project.

Available Tools

run_audit

Run a comprehensive Lighthouse audit on a URL.

Parameters:

  • url (required): The URL to audit
  • categories (optional): Array of categories to audit (defaults to all)
    • Options: "performance", "accessibility", "best-practices", "seo", "pwa"
  • device (optional): Device to emulate (defaults to "mobile")
    • Options: "mobile", "desktop"
  • throttling (optional): Whether to apply network throttling (defaults to true)

Example:

{ "url": "https://example.com", "categories": ["performance", "accessibility"], "device": "desktop", "throttling": false }

get_performance_score

Get just the performance score for a URL.

Parameters:

  • url (required): The URL to audit
  • device (optional): Device to emulate (defaults to "mobile")
    • Options: "mobile", "desktop"

Example:

{ "url": "https://example.com", "device": "mobile" }

Example Usage

Once the MCP server is configured, you can use it with Claude:

What's the performance score for example.com?

Claude will use the get_performance_score tool to analyze the website and return the results.

Requirements

  • Node.js 16+
  • Chrome/Chromium browser (for Lighthouse)

Endorsements

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Allows AI assistants such as Cursor/Cline/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!

  1. Features
    1. Installation
      1. Option 1: Using npx (Recommended)
      2. Option 2: Global Installation
      3. Option 3: Local Development
    2. MCP Configuration
      1. When installed via npm (global or npx)
      2. When using local development version
    3. Available Tools
      1. run_audit
      2. get_performance_score
    4. Example Usage
      1. Requirements
        1. Endorsements

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            Acts as a bridge between AI models and Google's PageSpeed Insights API, enabling detailed performance analysis of websites.
            Last updated -
            0
            4
            JavaScript
            MIT License
            • Linux
            • Apple
          • A
            security
            F
            license
            A
            quality
            Enables AI agents to interact with web browsers using natural language, featuring automated browsing, form filling, vision-based element detection, and structured JSON responses for systematic browser control.
            Last updated -
            1
            38
            Python
            • Linux
            • Apple
          • A
            security
            A
            license
            A
            quality
            This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
            Last updated -
            2
            5,133
            334
            JavaScript
            MIT License
            • Apple
            • Linux
          • A
            security
            A
            license
            A
            quality
            Enables AI models to analyze webpage performance using the Google PageSpeed Insights API, providing real-time performance scores and improvement suggestions.
            Last updated -
            1
            7
            1
            JavaScript
            MIT License

          View all related MCP servers

          ID: xip1afyf7n