local-only server

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

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.

Servidor MCP de Lighthouse

Un servidor MCP que envuelve la herramienta Lighthouse de Google para ayudar a medir varias métricas de rendimiento de las páginas web.

Características

Ejecute auditorías completas de Lighthouse en cualquier URL
Obtenga puntuaciones y métricas de rendimiento
Configurar la emulación del dispositivo (móvil/escritorio)
Controlar la limitación de la red
Seleccionar categorías de auditoría específicas

Instalación

Opción 1: Usar npx (recomendado)

Puede ejecutar la herramienta directamente usando npx sin instalación:

npx lighthouse-mcp

Opción 2: Instalación global

Instalar el paquete globalmente:

npm install -g lighthouse-mcp

Luego ejecútalo:

lighthouse-mcp

Opción 3: Desarrollo local

Clonar este repositorio
Instalar dependencias:
npm install
Construir el proyecto:
npm run build
Ejecutar el servidor:
npm start

Configuración de MCP

Cuando se instala a través de npm (global o npx)

Agregue lo siguiente a su archivo de configuración de MCP:

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

Al utilizar la versión de desarrollo local

Agregue lo siguiente a su archivo de configuración de MCP:

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

Reemplace /absolute/path/to/lighthouse-mcp con la ruta real a este proyecto.

Herramientas disponibles

ejecutar_auditoría

Ejecute una auditoría completa de Lighthouse en una URL.

Parámetros:

url (obligatorio): La URL a auditar
categories (opcional): Matriz de categorías para auditar (predeterminado: todas)
- Opciones: "rendimiento", "accesibilidad", "mejores prácticas", "seo", "pwa"
device (opcional): Dispositivo a emular (predeterminado "móvil")
- Opciones: "móvil", "escritorio"
throttling (opcional): si se debe aplicar limitación de red (el valor predeterminado es verdadero)

Ejemplo:

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

obtener_puntuación_de_rendimiento

Obtenga solo la puntuación de rendimiento de una URL.

Parámetros:

url (obligatorio): La URL a auditar
device (opcional): Dispositivo a emular (predeterminado "móvil")
- Opciones: "móvil", "escritorio"

Ejemplo:

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

Ejemplo de uso

Una vez configurado el servidor MCP, puedes usarlo con Claude:

What's the performance score for example.com?

Claude utilizará la herramienta get_performance_score para analizar el sitio web y devolver los resultados.

Requisitos

Node.js 16+
Navegador Chrome/Chromium (para Lighthouse)

Respaldos

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Permite que asistentes de IA como Cursor/Cline/GitHub Copilot utilicen la herramienta Lighthouse de Google para medir el rendimiento de tu página web. Después, puedes ejecutar un bucle de agente y hacer que los asistentes optimicen esas métricas.

Related Resources

Reddit Discussion about this server