Lighthouse MCP
Servidor Lighthouse MCP
Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades integrales de auditoría y análisis de rendimiento web mediante Google Lighthouse. Este servidor permite a los LLM y agentes de IA realizar evaluaciones detalladas del rendimiento de sitios web, auditorías de accesibilidad, análisis de SEO, comprobaciones de seguridad y monitoreo de Core Web Vitals.
🌟 Características principales
🚀 Análisis de rendimiento: Auditorías completas de Lighthouse con Core Web Vitals, puntuaciones de rendimiento y recomendaciones de optimización
♿ Auditorías de accesibilidad: Verificación de cumplimiento de WCAG y análisis de la puntuación de accesibilidad
🔍 Análisis de SEO: Auditorías de optimización para motores de búsqueda y recomendaciones de mejores prácticas
🔒 Evaluación de seguridad: Escaneo de HTTPS, CSP y vulnerabilidades de seguridad
📊 Análisis de recursos: Oportunidades de optimización de JavaScript, CSS, imágenes y fuentes
📱 Móvil vs Escritorio: Análisis comparativo entre dispositivos con opciones de limitación de ancho de banda
⚡ Core Web Vitals: Monitoreo de LCP, INP y CLS con verificación de umbrales
🎯 Presupuestos de rendimiento: Umbrales de rendimiento personalizados y monitoreo de presupuestos
🤖 Navegación agéntica: Auditorías de Lighthouse 13 para evaluar cómo una página sirve a agentes de IA (herramientas WebMCP, árbol de accesibilidad de agentes, llms.txt)
🧩 Salida estructurada: Cada herramienta declara un
outputSchemay devuelvestructuredContentvalidado, para que los clientes reciban datos tipificados en lugar de una cadena JSON que analizar📚 Recursos de referencia: Guías integradas y mejores prácticas para rendimiento web, accesibilidad, SEO y seguridad
Related MCP server: mcp-seo
🛠️ Requisitos
Node.js 22.0.0 o superior
Navegador Chrome/Chromium (gestionado automáticamente por Lighthouse)
VS Code, Cursor, Windsurf, Claude Desktop o cualquier otro cliente MCP
🚀 Primeros pasos
Instala el servidor Lighthouse MCP con tu cliente preferido usando una de las siguientes configuraciones:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}Perfiles de Chrome persistentes (sesiones de inicio de sesión)
Si necesitas sesiones autenticadas, inicia con un perfil de Chrome persistente y ejecuta con interfaz gráfica:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": [
"@danielsogl/lighthouse-mcp@latest",
"--profile-path",
"<profile-path>",
"--no-headless"
]
}
}
}Puedes pasar indicadores adicionales de Chrome con --chrome-flag, por ejemplo --chrome-flag=--disable-gpu.
Si el valor del indicador comienza con -- y coincide con un nombre de opción conocido, prefiere --chrome-flag=... para evitar analizarlo como una opción de nivel superior.
El modo de perfil desactiva el restablecimiento del almacenamiento de Lighthouse para que las cookies y el almacenamiento local persistan entre ejecuciones.
Si --user-data-dir apunta a un directorio inexistente, se creará y se tratará como un perfil nuevo.
Establece --profile-path en la Ruta de perfil que se muestra en chrome://version (p. ej., .../Default).
Nota: la depuración remota de Chrome requiere un directorio de datos de usuario no predeterminado, por lo que debes reutilizar un directorio de perfil dedicado en lugar del predeterminado del sistema.
También puedes pasar --user-data-dir + --profile-directory por separado si lo prefieres.
Adjuntar con --chrome-port únicamente no conserva el almacenamiento; incluye un indicador de perfil para mantener las sesiones.
Opciones de CLI
Indicadores de ejecución compatibles para el servidor MCP:
--profile-path <ruta>: usa la Ruta de perfil dechrome://version(deriva automáticamente el directorio de datos de usuario y el nombre del perfil)--user-data-dir <ruta>: reutiliza un directorio de perfil de Chrome para sesiones persistentes--profile-directory <nombre>: selecciona un perfil dentro del directorio de datos de usuario--chrome-path <ruta>: ruta explícita al ejecutable de Chrome/Chromium (anula la detección automática; también respeta la variable de entornoCHROME_PATH)--chrome-flag <indicador>o--chrome-flag=<indicador>: pasa indicadores adicionales de Chrome (repetible)--chrome-port <puerto>o--remote-debugging-port <puerto>: se conecta a una instancia existente de Chrome iniciada con depuración remota habilitada--headless: fuerza el modo sin interfaz gráfica--no-headless: fuerza el modo con interfaz gráfica
Registro de eventos
Lighthouse registra en stderr. El servidor lo mantiene en error para no saturar los registros de tu
cliente MCP; establece LIGHTHOUSE_LOG_LEVEL en silent, info o verbose al depurar
(por ejemplo, cuando Chrome no se inicia).
LIGHTHOUSE_LOG_LEVEL=verbose npx @danielsogl/lighthouse-mcp@latestWSL2 / Ruta personalizada de Chrome
Si se selecciona un binario de Chrome incorrecto (p. ej., Chrome de Windows en lugar del binario de Linux en WSL2), establece la ruta explícitamente:
# Via CLI flag
npx @danielsogl/lighthouse-mcp@latest --chrome-path /usr/bin/google-chrome
# Via environment variable
CHROME_PATH=/usr/bin/google-chrome npx @danielsogl/lighthouse-mcp@latestEn tu configuración de MCP:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest", "--chrome-path", "/usr/bin/google-chrome"]
}
}
}Prueba de humo E2E (perfil)
Ejecuta una auditoría real con un perfil persistente (usa un directorio de perfil existente e inicia sesión una vez si es necesario):
npm run smoke:profile -- --url https://example.com \
--profile-path "<profile-path>" \
--no-headlessPrueba de humo E2E (conexión a Chrome existente)
Inicia Chrome con depuración remota habilitada:
/path/to/GoogleChromeExecutable \
--remote-debugging-port=9222 \
--user-data-dir /path/to/chrome-profileReemplaza /ruta/al/ejecutable/de/Chrome con la ruta del binario de Chrome/Chromium de tu plataforma.
Luego conecta Lighthouse a esa instancia:
npm run smoke:profile -- --url https://example.com --chrome-port 9222Para conservar el almacenamiento al conectarte, pasa la ruta del perfil para que Lighthouse conserve las cookies y el almacenamiento local:
npm run smoke:profile -- --url https://example.com \
--chrome-port 9222 \
--profile-path "<profile-path>"Instalación en VS Code
También puedes instalar el servidor Lighthouse MCP usando la CLI de VS Code:
# For VS Code
code --add-mcp '{"name":"lighthouse","command":"npx","args":["-y","@danielsogl/lighthouse-mcp@latest"]}'
# For VS Code Insiders
code-insiders --add-mcp '{"name":"lighthouse","command":"npx","args":["-y","@danielsogl/lighthouse-mcp@latest"]}'Después de la instalación, el servidor Lighthouse MCP estará disponible para usarse con tu agente GitHub Copilot en VS Code.
Instalación en Cursor
Ve a Cursor Settings → MCP → Add new MCP Server. Nómbralo "lighthouse", usa el tipo command con el comando npx @danielsogl/lighthouse-mcp@latest:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}Instalación en Windsurf
Sigue la documentación de MCP de Windsurf. Usa la siguiente configuración:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}Instalación en Claude Desktop
Sigue la guía de instalación de MCP y usa la siguiente configuración:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}🔧 Herramientas disponibles
El servidor Lighthouse MCP proporciona las siguientes herramientas para un análisis web integral:
🏁 Herramientas de auditoría
Herramienta | Descripción | Parámetros |
| Ejecuta una auditoría integral de Lighthouse |
|
| Obtiene la puntuación de accesibilidad y recomendaciones |
|
| Obtiene el análisis de SEO y recomendaciones |
|
⚡ Herramientas de rendimiento
Herramienta | Descripción | Parámetros |
| Obtiene la puntuación general de rendimiento |
|
| Obtiene las métricas de Core Web Vitals |
|
| Compara el rendimiento entre dispositivos |
|
| Verifica los presupuestos de rendimiento |
|
| Encuentra oportunidades de optimización de LCP |
|
🔍 Herramientas de análisis
Herramienta | Descripción | Parámetros |
| Encuentra código JavaScript sin usar |
|
| Analiza todos los recursos del sitio web |
|
🔒 Herramientas de seguridad
Herramienta | Descripción | Parámetros |
| Realiza una auditoría de seguridad integral |
|
💬 Prompts disponibles
El servidor Lighthouse MCP incluye prompts reutilizables que ayudan a los LLM a proporcionar análisis y recomendaciones estructurados:
📊 Prompts de análisis
Prompt | Descripción | Parámetros |
| Analiza los resultados de la auditoría de Lighthouse |
|
| Compara resultados de auditoría antes/después |
|
| Obtén recomendaciones de optimización de Core Web Vitals |
|
| Obtén recomendaciones de optimización de recursos |
|
📚 Recursos disponibles
El servidor Lighthouse MCP proporciona recursos de referencia integrados con pautas esenciales y mejores prácticas:
Recurso | Descripción | URI |
| Umbrales de rendimiento de Core Web Vitals |
|
| Técnicas de optimización del rendimiento y su impacto |
|
| Pautas de accesibilidad WCAG 2.1 y problemas |
|
| Mejores prácticas de SEO y oportunidades de optimización |
|
| Mejores prácticas de seguridad web y vulnerabilidades |
|
| Recomendaciones de presupuesto de rendimiento por tipo de sitio |
|
| Categorías de auditoría de Lighthouse y métodos de puntuación |
|
| Guías de optimización específicas para frameworks |
|
🎯 Prompts de estrategia
Prompt | Descripción | Parámetros |
| Generar un plan integral de mejora del rendimiento |
|
| Crear recomendaciones personalizadas de presupuesto de rendimiento |
|
| Generar recomendaciones de mejora de SEO |
|
| Crear una guía de mejora de accesibilidad |
|
🔧 Detalles de parámetros de prompt
auditResults: Resultados de auditoría JSON de las herramientas de LighthousefocusArea: Categoría específica en la que centrarse ("performance","accessibility","seo","best-practices","agentic-browsing")beforeAudit/afterAudit: Resultados de auditoría de Lighthouse antes y después de los cambioschangesImplemented: Descripción de los cambios realizados entre auditoríascurrentMetrics: Métricas de rendimiento actuales de las auditoríastargetGoals: Objetivos de rendimiento específicos o metas empresarialestimeframe: Cronograma para implementar mejorasframework: Framework frontend o pila tecnológicaconstraints: Restricciones técnicas o empresarialeswebsiteType: Tipo de sitio web (p. ej., comercio electrónico, blog, corporativo)targetAudience: Información sobre el público objetivo o el mercadocomplianceLevel: Nivel de cumplimiento de WCAG ("AA"o"AAA")userGroups: Grupos de usuarios específicos a considerar para la accesibilidad
📋 Detalles de parámetros
Parámetros comunes
url(obligatorio): La URL del sitio web a analizardevice: Dispositivo objetivo ("desktop"o"mobile", predeterminado:"desktop")includeDetails: Incluir información detallada de la auditoría (predeterminado:false)throttling: Habilitar la limitación de red/CPU (predeterminado:false)
Parámetros específicos
categories: Categorías de Lighthouse a auditar (["performance", "accessibility", "best-practices", "seo", "agentic-browsing"])threshold: Umbrales personalizados para métricas (p. ej.,{"lcp": 2.5, "inp": 200, "cls": 0.1})budget: Límites de presupuesto de rendimiento (p. ej.,{"performanceScore": 90, "largestContentfulPaint": 2500})resourceTypes: Tipos de recursos a analizar (["images", "javascript", "css", "fonts", "other"])minBytes: Umbral mínimo de tamaño de archivo para el análisis (predeterminado:2048)checks: Comprobaciones de seguridad a realizar (["https", "csp", "hsts", "origin-isolation", "clickjacking", "trusted-types", "third-party-cookies", "deprecations"])
💡 Ejemplos de uso
Auditoría básica de rendimiento
// Get overall performance score
{
"tool": "get_performance_score",
"arguments": {
"url": "https://example.com",
"device": "mobile"
}
}Análisis de Core Web Vitals
// Check Core Web Vitals with custom thresholds
{
"tool": "get_core_web_vitals",
"arguments": {
"url": "https://example.com",
"device": "mobile",
"includeDetails": true,
"threshold": {
"lcp": 2.5,
"inp": 200,
"cls": 0.1
}
}
}Evaluación de seguridad
// Comprehensive security audit
{
"tool": "get_security_audit",
"arguments": {
"url": "https://example.com",
"checks": ["https", "csp", "hsts"]
}
}Optimización de recursos
// Find optimization opportunities
{
"tool": "analyze_resources",
"arguments": {
"url": "https://example.com",
"resourceTypes": ["images", "javascript"],
"minSize": 1024
}
}Uso de recursos de referencia
Accede a las pautas y mejores prácticas integradas:
// Get Core Web Vitals thresholds
{
"resource": {
"uri": "lighthouse://performance/core-web-vitals-thresholds"
}
}
// Access WCAG accessibility guidelines
{
"resource": {
"uri": "lighthouse://accessibility/wcag-guidelines"
}
}
// Get framework-specific optimization guides
{
"resource": {
"uri": "lighthouse://frameworks/optimization-guides"
}
}Uso de prompts para análisis
// Analyze audit results with focused recommendations
{
"prompt": "analyze-audit-results",
"arguments": {
"auditResults": "{...lighthouse audit json...}",
"focusArea": "performance"
}
}
// Create a performance improvement plan
{
"prompt": "create-performance-plan",
"arguments": {
"currentMetrics": "{...current performance metrics...}",
"targetGoals": "Achieve 90+ performance score and sub-2s LCP",
"timeframe": "3 months"
}
}
// Compare before/after audit results
{
"prompt": "compare-audits",
"arguments": {
"beforeAudit": "{...before audit results...}",
"afterAudit": "{...after audit results...}",
"changesImplemented": "Implemented lazy loading and image optimization"
}
}🎯 Casos de uso
Monitoreo de rendimiento: seguimiento automatizado del rendimiento y monitoreo de Core Web Vitals
Cumplimiento de accesibilidad: verificación de cumplimiento de WCAG 2.1 y orientación para la corrección
Optimización de SEO: auditorías técnicas de SEO y recomendaciones de optimización para motores de búsqueda
Evaluación de seguridad: escaneo de vulnerabilidades y validación de mejores prácticas de seguridad
Optimización de recursos: análisis de bundles e identificación de oportunidades de optimización
Presupuestos de rendimiento: monitoreo automatizado de presupuestos de rendimiento y alertas
Integración CI/CD: puertas de calidad automatizadas y detección de regresiones de rendimiento
🏗️ Arquitectura
El servidor está construido con:
Model Context Protocol SDK: Para la implementación del servidor MCP
Google Lighthouse: Para la auditoría de rendimiento web
Chrome Launcher: Para la automatización del navegador
TypeScript: Para seguridad de tipos y una mejor experiencia de desarrollo
Zod: Para la validación de esquemas en tiempo de ejecución
🧪 Pruebas
npm run test:run # unit tests
npm run test:coverage # unit tests with coverage
npm run test:e2e # end-to-end testsLa suite de extremo a extremo compila el servidor, lo inicia a través de stdio con un cliente MCP real y ejecuta auditorías reales de Lighthouse contra una página de prueba servida en loopback. Requiere que Chrome esté instalado; establece CHROME_PATH si se encuentra en una ubicación no estándar.
🤝 Contribuciones
¡Las contribuciones son bienvenidas! Consulta nuestra Guía de contribución para obtener detalles sobre:
Estilo y estándares de código
Requisitos de pruebas
Proceso de pull requests
Configuración de desarrollo
📜 Licencia
Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para obtener más detalles.
🔒 Seguridad
Para problemas de seguridad, consulta nuestra Política de seguridad.
📞 Soporte
🐛 Informes de errores: GitHub Issues
💬 Discusiones: GitHub Discussions
📧 Correo electrónico: security@codingrules.ai
🙏 Agradecimientos
Al equipo de Google Lighthouse por el excelente motor de auditoría
A Anthropic por la especificación del Model Context Protocol
A la comunidad de código abierto por la inspiración y las contribuciones continuas
Construido con ❤️ por Daniel Sogl
Available Tools
11 toolsanalyze_resourcesAnalyze Page ResourcesARead-only
Analyze website resources (images, JS, CSS, fonts) for optimization opportunities
Inputs: url (required), device, minSize, resourceTypes. Returns: url, device, filters, summary, +3 more
check_performance_budgetCheck Performance BudgetBRead-only
Check if website performance meets specified budget thresholds
Inputs: url (required), budget (required), device. Returns: data, summary, recommendations
compare_mobile_desktopCompare Mobile vs DesktopARead-only
Compare website performance between mobile and desktop devices
Inputs: url (required), categories, throttling, includeDetails. Returns: data, summary, recommendations
find_unused_javascriptFind Unused JavaScriptBRead-only
Find unused JavaScript code to reduce bundle size
Inputs: url (required), device, minBytes. Returns: url, device, summary, timestamp, +3 more
get_accessibility_scoreGet Accessibility ScoreBRead-only
Get the accessibility score and recommendations for a website
Inputs: url (required), device, includeDetails. Returns: data, summary, recommendations
get_core_web_vitalsGet Core Web VitalsARead-only
Get Core Web Vitals metrics for a website
Inputs: url (required), device, threshold, includeDetails. Returns: data, summary, recommendations
get_lcp_opportunitiesGet LCP OpportunitiesBRead-only
Get LCP optimization opportunities for a website
Inputs: url (required), device, threshold, includeDetails. Returns: data, summary, recommendations
get_performance_scoreGet Performance ScoreCRead-only
Get the performance score for a website
Inputs: url (required), device. Returns: data, summary, recommendations
get_security_auditGet Security AuditARead-only
Perform security audit checking HTTPS, CSP, and other security measures
Inputs: url (required), checks, device. Returns: data, summary, recommendations
get_seo_analysisGet SEO AnalysisCRead-only
Get SEO analysis and recommendations for a website
Inputs: url (required), device, includeDetails. Returns: data, summary, recommendations
run_auditRun Lighthouse AuditBRead-only
Run a comprehensive Lighthouse audit on a website
Inputs: url (required), device, categories, throttling. Returns: data, summary, recommendations
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
There is significant overlap between run_audit and the specific getter tools (accessibility, SEO, performance), as run_audit likely encompasses all of those. Additionally, get_lcp_opportunities, find_unused_javascript, and analyze_resources all target performance optimization with unclear boundaries.
Most tools follow a clear verb_noun pattern (e.g., get_*, run_audit, compare_mobile_desktop, check_performance_budget). Minor deviations include run_audit vs. get_security_audit (both use 'audit' but different verbs) and find_unused_javascript/analyze_resources not using 'get_' prefix, but the overall convention is consistent.
With 11 tools, the set is well-scoped for a website auditing server. Each tool covers a distinct aspect of Lighthouse auditing (performance, SEO, accessibility, security, resources), and the count is within the ideal 3-15 range without feeling bloated.
The tool surface covers major Lighthouse categories (performance, accessibility, SEO, security, Core Web Vitals, resources) and includes useful extras like budget checks and mobile/desktop comparison. However, it lacks explicit best practices and PWA audits, which are standard Lighthouse categories, creating minor gaps.
Maintenance
Related MCP Connectors
Free MCP server that audits any public URL: technical SEO, Core Web Vitals, indexing checks.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Website QA for your coding agent: audit SEO, performance, security, accessibility over MCP.
Your agent needs to crawl a site and say what is wrong with it — broken tags, duplicate content, pages nothing can index, resources that never load. **What you can ask for** • "Crawl this site and list every page with a duplicate title or missing description." • "Which pages are non-indexable, and why?" • "Run Lighthouse on these URLs and give me the failing audits." • "Show the internal link graph and the orphan pages." • "Give me this page's raw HTML and its microdata." **How to use it** Point any MCP client at https://mcp.aisa.one/seo-onpage/mcp and sign in with OAuth — there is no key to create or paste. 20 tools: submit a crawl and read its summary, pages, resources, links and waterfall; duplicate content and duplicate tags; keyword density; non-indexable and uncrawlable resources; parsed content, raw HTML, microdata, screenshots and Lighthouse. **Why this rather than the source** A crawler you drive from the agent, with the audit results as structured data rather than a PDF. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the broken pages here, then ask the same agent what those pages used to rank for — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/seo/mcp for all of it at once — rankings, keywords, backlinks, site health and AI-answer visibility across DataForSEO, Semrush and Ahrefs.
Related MCP Servers
- AlicenseAqualityDmaintenanceA comprehensive MCP server providing 15 web tools including search, scraping, screenshots, SEO audits, and DNS/SSL checks through a single installation. It delivers clean, LLM-optimized outputs so AI agents can focus on reasoning rather than parsing raw HTML.156 npmMIT
- AlicenseAqualityDmaintenanceEnables AI agents to perform comprehensive SEO audits on web pages, including meta tags, headings, links, images, performance, and more, via a CLI or MCP server.182MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for SEO, performance, GEO, and UX audits with 37 tools covering technical SEO, Lighthouse performance, AI search optimization, content analysis, accessibility, security, and more.1MIT
- AlicenseAqualityDmaintenanceAn MCP server that audits websites for accessibility (WCAG 2.1 AA/EAA), performance, SEO, design quality, and mobile responsiveness, providing actionable scores, grades, and prioritized fixes.6MIT