Skip to main content
Glama

Lighthouse MCP Server

NPM Version License: MIT Node Version CI Coverage Sponsor

Сервер Model Context Protocol (MCP), который предоставляет расширенные возможности аудита и анализа производительности веб-сайтов с помощью Google Lighthouse. Этот сервер позволяет LLM и AI-агентам выполнять детальную оценку производительности сайтов, аудит доступности, SEO-анализ, проверки безопасности и мониторинг Core Web Vitals.

🌟 Ключевые возможности

  • 🚀 Анализ производительности: Полные аудиты Lighthouse с Core Web Vitals, показателями производительности и рекомендациями по оптимизации

  • ♿ Аудит доступности: Проверка соответствия WCAG и анализ показателя доступности

  • 🔍 SEO-анализ: Аудиты поисковой оптимизации и рекомендации по лучшим практикам

  • 🔒 Оценка безопасности: Сканирование HTTPS, CSP и уязвимостей безопасности

  • 📊 Анализ ресурсов: Возможности оптимизации JavaScript, CSS, изображений и шрифтов

  • 📱 Мобильные и десктопные устройства: Сравнительный анализ между устройствами с опциями троттлинга

  • ⚡ Core Web Vitals: Мониторинг LCP, INP, CLS с проверкой пороговых значений

  • 🎯 Бюджеты производительности: Пользовательские пороговые значения производительности и мониторинг бюджета

  • 🤖 Агентный просмотр: Аудиты Lighthouse 13 для оценки того, насколько страница подходит для AI-агентов (WebMCP tools, дерево доступности для агентов, llms.txt)

  • 🧩 Структурированный вывод: Каждый инструмент объявляет outputSchema и возвращает проверенный structuredContent, поэтому клиенты получают типизированные данные вместо строки JSON для разбора

  • 📚 Справочные ресурсы: Встроенные руководства и лучшие практики для веб-производительности, доступности, SEO и безопасности

Related MCP server: mcp-seo

🛠️ Требования

  • Node.js 22.0.0 или новее

  • Браузер Chrome/Chromium (автоматически управляется Lighthouse)

  • VS Code, Cursor, Windsurf, Claude Desktop или любой другой MCP-клиент

🚀 Начало работы

Установите Lighthouse MCP server с помощью предпочитаемого клиента, используя одну из конфигураций ниже:

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": ["@danielsogl/lighthouse-mcp@latest"]
    }
  }
}

Постоянные профили Chrome (сеансы входа)

Если вам нужны сеансы с аутентификацией, запустите с постоянным профилем Chrome и в режиме с интерфейсом (headed):

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": [
        "@danielsogl/lighthouse-mcp@latest",
        "--profile-path",
        "<profile-path>",
        "--no-headless"
      ]
    }
  }
}

Вы можете передавать дополнительные флаги Chrome с помощью --chrome-flag, например --chrome-flag=--disable-gpu. Если значение флага начинается с -- и совпадает с известным именем опции, используйте --chrome-flag=..., чтобы оно не было распознано как опция верхнего уровня. Режим профиля отключает сброс хранилища Lighthouse, поэтому cookies и локальное хранилище сохраняются между запусками. Если --user-data-dir указывает на несуществующую директорию, она будет создана и воспринята как новый профиль. Укажите --profile-path как Profile Path, показанный в chrome://version (например, .../Default). Примечание: удалённая отладка Chrome требует нестандартной директории пользовательских данных, поэтому используйте выделенную директорию профиля вместо системной по умолчанию. Вы также можете передать --user-data-dir и --profile-directory отдельно, если предпочитаете. Подключение только через --chrome-port не сохраняет хранилище; добавьте флаг профиля, чтобы сохранять сеансы.

Параметры командной строки

Поддерживаемые флаги времени выполнения для MCP-сервера:

  • --profile-path <path>: использовать Profile Path из chrome://version (автоматически определяет директорию пользовательских данных и имя профиля)

  • --user-data-dir <path>: использовать директорию профиля Chrome для постоянных сеансов

  • --profile-directory <name>: выбрать профиль внутри директории пользовательских данных

  • --chrome-path <path>: явный путь к исполняемому файлу Chrome/Chromium (переопределяет автоматическое определение; также учитывает переменную окружения CHROME_PATH)

  • --chrome-flag <flag> или --chrome-flag=<flag>: передать дополнительные флаги Chrome (можно повторять)

  • --chrome-port <port> или --remote-debugging-port <port>: подключиться к существующему экземпляру Chrome, запущенному с включённой удалённой отладкой

  • --headless: принудительно включить headless-режим

  • --no-headless: принудительно включить режим с интерфейсом

Логирование

Lighthouse пишет логи в stderr. Сервер держит этот уровень на error, чтобы не переполнять журналы вашего MCP-клиента; установите LIGHTHOUSE_LOG_LEVEL в silent, info или verbose при отладке (например, когда Chrome не удаётся запустить).

LIGHTHOUSE_LOG_LEVEL=verbose npx @danielsogl/lighthouse-mcp@latest

WSL2 / Пользовательский путь к Chrome

Если подхватывается не тот исполняемый файл Chrome (например, Windows Chrome вместо Linux-бинарника в WSL2), укажите путь явно:

# 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@latest

В вашей MCP-конфигурации:

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": ["@danielsogl/lighthouse-mcp@latest", "--chrome-path", "/usr/bin/google-chrome"]
    }
  }
}

E2E Smoke-тест (профиль)

Запустите реальный аудит с постоянным профилем (используйте существующую директорию профиля и при необходимости один раз войдите в систему):

npm run smoke:profile -- --url https://example.com \
  --profile-path "<profile-path>" \
  --no-headless

E2E Smoke-тест (подключение к запущенному Chrome)

Запустите Chrome с включённой удалённой отладкой:

/path/to/GoogleChromeExecutable \
  --remote-debugging-port=9222 \
  --user-data-dir /path/to/chrome-profile

Замените /path/to/GoogleChromeExecutable на путь к бинарнику Chrome/Chromium вашей платформы.

Затем подключите Lighthouse к этому экземпляру:

npm run smoke:profile -- --url https://example.com --chrome-port 9222

Чтобы сохранить хранилище при подключении, передайте путь к профилю, чтобы Lighthouse сохранял cookies/локальное хранилище:

npm run smoke:profile -- --url https://example.com \
  --chrome-port 9222 \
  --profile-path "<profile-path>"

Установка в VS Code

Вы также можете установить Lighthouse MCP server с помощью CLI 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"]}'

После установки Lighthouse MCP server будет доступен для использования с вашим агентом GitHub Copilot в VS Code.

Установка в Cursor

Install MCP Server

Перейдите в Cursor Settings → MCP → Add new MCP Server. Назовите его "lighthouse", используйте тип command с командой npx @danielsogl/lighthouse-mcp@latest:

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": ["@danielsogl/lighthouse-mcp@latest"]
    }
  }
}

Установка в Windsurf

Следуйте документации по Windsurf MCP. Используйте следующую конфигурацию:

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": ["@danielsogl/lighthouse-mcp@latest"]
    }
  }
}

Установка в Claude Desktop

Следуйте руководству по установке MCP, используйте следующую конфигурацию:

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": ["@danielsogl/lighthouse-mcp@latest"]
    }
  }
}

🔧 Доступные инструменты

Lighthouse MCP server предоставляет следующие инструменты для комплексного веб-анализа:

🏁 Инструменты аудита

Tool

Description

Parameters

run_audit

Выполнить комплексный аудит Lighthouse

url, categories?, device?, throttling?

get_accessibility_score

Получить оценку доступности и рекомендации

url, device?, includeDetails?

get_seo_analysis

Получить SEO-анализ и рекомендации

url, device?, includeDetails?

⚡ Инструменты производительности

Tool

Description

Parameters

get_performance_score

Получить общий показатель производительности

url, device?

get_core_web_vitals

Получить метрики Core Web Vitals

url, device?, includeDetails?, threshold?

compare_mobile_desktop

Сравнить производительность на разных устройствах

url, categories?, throttling?, includeDetails?

check_performance_budget

Проверить соответствие бюджетам производительности

url, device?, budget

get_lcp_opportunities

Найти возможности оптимизации LCP

url, device?, includeDetails?, threshold?

🔍 Инструменты анализа

Tool

Description

Parameters

find_unused_javascript

Найти неиспользуемый код JavaScript

url, device?, minBytes?, includeSourceMaps?

analyze_resources

Проанализировать все ресурсы веб-сайта

url, device?, resourceTypes?, minSize?

🔒 Инструменты безопасности

Tool

Description

Parameters

get_security_audit

Выполнить комплексный аудит безопасности

url, device?, checks?

💬 Доступные промпты

Lighthouse MCP server включает переиспользуемые промпты, которые помогают LLM предоставлять структурированный анализ и рекомендации:

📊 Промпты для анализа

Prompt

Description

Parameters

analyze-audit-results

Проанализировать результаты аудита Lighthouse

auditResults, focusArea?

compare-audits

Сравнить результаты аудита до и после

beforeAudit, afterAudit, changesImplemented?

optimize-core-web-vitals

Получить рекомендации по оптимизации Core Web Vitals

coreWebVitals, framework?, constraints?

optimize-resources

Получить рекомендации по оптимизации ресурсов

resourceAnalysis, loadingStrategy?, criticalUserJourneys?

📚 Доступные ресурсы

Lighthouse MCP server предоставляет встроенные справочные ресурсы с основными руководствами и лучшими практиками:

Ресурс

Описание

URI

core-web-vitals-thresholds

Пороговые значения Core Web Vitals

lighthouse://performance/core-web-vitals-thresholds

optimization-techniques

Методы оптимизации производительности и их влияние

lighthouse://performance/optimization-techniques

wcag-guidelines

Рекомендации по доступности WCAG 2.1 и проблемы

lighthouse://accessibility/wcag-guidelines

seo-best-practices

Лучшие практики SEO и возможности оптимизации

lighthouse://seo/best-practices

security-best-practices

Лучшие практики веб-безопасности и уязвимости

lighthouse://security/best-practices

budget-guidelines

Рекомендации по бюджету производительности по типам сайтов

lighthouse://performance/budget-guidelines

categories-scoring

Категории аудита Lighthouse и методы оценки

lighthouse://audits/categories-scoring

framework-guides

Руководства по оптимизации для конкретных фреймворков

lighthouse://frameworks/optimization-guides

🎯 Стратегические подсказки

Подсказка

Описание

Параметры

create-performance-plan

Создать комплексный план улучшения производительности

currentMetrics, targetGoals?, timeframe?

create-performance-budget

Создать индивидуальные рекомендации по бюджету производительности

currentMetrics, businessGoals?, userBase?

seo-recommendations

Сформировать рекомендации по улучшению SEO

seoAudit, websiteType?, targetAudience?

accessibility-guide

Создать руководство по улучшению доступности

accessibilityAudit, complianceLevel?, userGroups?

🔧 Детали параметров подсказок

  • auditResults: JSON-результаты аудита из инструментов Lighthouse

  • focusArea: Конкретная категория для фокусировки ("performance", "accessibility", "seo", "best-practices", "agentic-browsing")

  • beforeAudit / afterAudit: Результаты аудита Lighthouse до и после изменений

  • changesImplemented: Описание изменений, внесённых между аудитами

  • currentMetrics: Текущие показатели производительности из аудитов

  • targetGoals: Конкретные цели по производительности или бизнес-цели

  • timeframe: Сроки для внедрения улучшений

  • framework: Фронтенд-фреймворк или технологический стек

  • constraints: Технические или бизнес-ограничения

  • websiteType: Тип веб-сайта (например, электронная коммерция, блог, корпоративный)

  • targetAudience: Целевая аудитория или информация о рынке

  • complianceLevel: Уровень соответствия WCAG ("AA" или "AAA")

  • userGroups: Конкретные группы пользователей для учёта доступности

📋 Детали параметров

Общие параметры

  • url (обязательный): URL веб-сайта для анализа

  • device: Целевое устройство ("desktop" или "mobile", по умолчанию: "desktop")

  • includeDetails: Включать детальную информацию аудита (по умолчанию: false)

  • throttling: Включить ограничение сети/ЦП (по умолчанию: false)

Специфические параметры

  • categories: Категории Lighthouse для аудита (["performance", "accessibility", "best-practices", "seo", "agentic-browsing"])

  • threshold: Пользовательские пороговые значения для метрик (например, {"lcp": 2.5, "inp": 200, "cls": 0.1})

  • budget: Лимиты бюджета производительности (например, {"performanceScore": 90, "largestContentfulPaint": 2500})

  • resourceTypes: Типы ресурсов для анализа (["images", "javascript", "css", "fonts", "other"])

  • minBytes: Минимальный размер файла для анализа (по умолчанию: 2048)

  • checks: Проверки безопасности для выполнения (["https", "csp", "hsts", "origin-isolation", "clickjacking", "trusted-types", "third-party-cookies", "deprecations"])

💡 Примеры использования

Базовый аудит производительности

// Get overall performance score
{
  "tool": "get_performance_score",
  "arguments": {
    "url": "https://example.com",
    "device": "mobile"
  }
}

Анализ 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
    }
  }
}

Оценка безопасности

// Comprehensive security audit
{
  "tool": "get_security_audit",
  "arguments": {
    "url": "https://example.com",
    "checks": ["https", "csp", "hsts"]
  }
}

Оптимизация ресурсов

// Find optimization opportunities
{
  "tool": "analyze_resources",
  "arguments": {
    "url": "https://example.com",
    "resourceTypes": ["images", "javascript"],
    "minSize": 1024
  }
}

Использование справочных ресурсов

Доступ к встроенным руководствам и лучшим практикам:

// 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"
  }
}

Использование подсказок для анализа

// 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"
  }
}

🎯 Варианты использования

  • Мониторинг производительности: Автоматическое отслеживание производительности и мониторинг Core Web Vitals

  • Соответствие доступности: Проверка соответствия WCAG 2.1 и рекомендации по исправлению

  • Оптимизация SEO: Технические аудиты SEO и рекомендации по оптимизации поисковых систем

  • Оценка безопасности: Сканирование уязвимостей и проверка лучших практик безопасности

  • Оптимизация ресурсов: Анализ бандлов и выявление возможностей оптимизации

  • Бюджеты производительности: Автоматический мониторинг бюджета производительности и оповещения

  • Интеграция с CI/CD: Автоматические шлюзы качества и обнаружение регрессий производительности

🏗️ Архитектура

Сервер построен с использованием:

  • Model Context Protocol SDK: Для реализации MCP-сервера

  • Google Lighthouse: Для аудита веб-производительности

  • Chrome Launcher: Для автоматизации браузера

  • TypeScript: Для типобезопасности и лучшего опыта разработки

  • Zod: Для проверки схем во время выполнения

🧪 Тестирование

npm run test:run      # unit tests
npm run test:coverage # unit tests with coverage
npm run test:e2e      # end-to-end tests

Комплексный набор тестов собирает сервер, запускает его через stdio с реальным MCP-клиентом и выполняет фактические аудиты Lighthouse на фиктивной странице, размещённой на loopback. Требуется установленный Chrome; задайте CHROME_PATH, если он находится в нестандартном месте.

🤝 Вклад

Вклад приветствуется! Пожалуйста, ознакомьтесь с нашим Руководством по вкладу для получения информации о:

  • Стиле кода и стандартах

  • Требованиях к тестированию

  • Процессе pull request

  • Настройке среды разработки

📜 Лицензия

Этот проект лицензирован под лицензией MIT — см. файл LICENSE.

🔒 Безопасность

По вопросам безопасности обращайтесь к нашей Политике безопасности.

📞 Поддержка

🙏 Благодарности

  • Команде Google Lighthouse за отличный движок аудита

  • Anthropic за спецификацию Model Context Protocol

  • Сообществу открытого кода за постоянное вдохновение и вклад


Сделано с ❤️ Daniel Sogl

Available Tools

11 tools
analyze_resourcesAnalyze Page ResourcesA
Read-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 BudgetB
Read-only

Check if website performance meets specified budget thresholds

Inputs: url (required), budget (required), device. Returns: data, summary, recommendations

compare_mobile_desktopCompare Mobile vs DesktopA
Read-only

Compare website performance between mobile and desktop devices

Inputs: url (required), categories, throttling, includeDetails. Returns: data, summary, recommendations

find_unused_javascriptFind Unused JavaScriptB
Read-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 ScoreB
Read-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 VitalsA
Read-only

Get Core Web Vitals metrics for a website

Inputs: url (required), device, threshold, includeDetails. Returns: data, summary, recommendations

get_lcp_opportunitiesGet LCP OpportunitiesB
Read-only

Get LCP optimization opportunities for a website

Inputs: url (required), device, threshold, includeDetails. Returns: data, summary, recommendations

get_performance_scoreGet Performance ScoreC
Read-only

Get the performance score for a website

Inputs: url (required), device. Returns: data, summary, recommendations

get_security_auditGet Security AuditA
Read-only

Perform security audit checking HTTPS, CSP, and other security measures

Inputs: url (required), checks, device. Returns: data, summary, recommendations

get_seo_analysisGet SEO AnalysisC
Read-only

Get SEO analysis and recommendations for a website

Inputs: url (required), device, includeDetails. Returns: data, summary, recommendations

run_auditRun Lighthouse AuditB
Read-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

    B3.3/5.0

    Scored across 11 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    • Free MCP server that audits any public URL: technical SEO, Core Web Vitals, indexing checks.

      https://audit.pronovatx.com/mcp
    • MCP server for building and testing AI agents with multi-model experimentation and insights.

      https://api.anotherai.dev/mcp
    • Website QA for your coding agent: audit SEO, performance, security, accessibility over MCP.

      https://mcp.squirrelscan.com/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

    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      15
      6 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      18
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      6
      MIT