# lighthouse-mcp

Runs Google Lighthouse checks on web pages and returns scores and metrics. Use it to inspect performance, accessibility, SEO, or best practices.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 212
- Author: priyankark
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/priyankark/lighthouse-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/lighthouse-mcp

## What it does

The server exposes `run_audit` for a full page check and `get_performance_score` for a performance score. With a full audit, you can choose categories, emulate a phone or desktop, and switch network throttling on or off. If omitted, all categories are checked with mobile emulation and throttling enabled.

You need Node.js 22.19+ and Chrome or Chromium. Audits run serially, with a time limit for each; Chrome and the audit proxy are shut down when a run ends or fails. Loopback access is allowed by default, while private and metadata destinations are blocked. Because a page may reach services on your own machine through loopback, only audit sites you trust.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add lighthouse-mcp -- npx -y lighthouse-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add lighthouse-mcp -- npx -y lighthouse-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lighthouse-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "lighthouse-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "lighthouse-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "lighthouse-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add lighthouse-mcp npx -y lighthouse-mcp
```

## When to use it
- get a performance score for a page
- check a site’s accessibility and SEO
- run an audit with desktop or mobile emulation
- choose which Lighthouse categories to inspect
- compare checks with network throttling enabled or disabled

## Example prompts
- Run a Lighthouse audit of `https://example.com` for performance and accessibility on desktop.
- Get the mobile performance score for `https://example.com`.
- Check `https://example.com` for SEO and best practices.

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [mockserver](https://affpapa.org/en/nevibecode/mcp/mockserver.md) — MCP server · ★ 4996

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md