Lighthouse MCP
Lighthouse MCP Server
Сервер 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@latestWSL2 / Пользовательский путь к 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-headlessE2E 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
Перейдите в 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 |
| Выполнить комплексный аудит Lighthouse |
|
| Получить оценку доступности и рекомендации |
|
| Получить SEO-анализ и рекомендации |
|
⚡ Инструменты производительности
Tool | Description | Parameters |
| Получить общий показатель производительности |
|
| Получить метрики Core Web Vitals |
|
| Сравнить производительность на разных устройствах |
|
| Проверить соответствие бюджетам производительности |
|
| Найти возможности оптимизации LCP |
|
🔍 Инструменты анализа
Tool | Description | Parameters |
| Найти неиспользуемый код JavaScript |
|
| Проанализировать все ресурсы веб-сайта |
|
🔒 Инструменты безопасности
Tool | Description | Parameters |
| Выполнить комплексный аудит безопасности |
|
💬 Доступные промпты
Lighthouse MCP server включает переиспользуемые промпты, которые помогают LLM предоставлять структурированный анализ и рекомендации:
📊 Промпты для анализа
Prompt | Description | Parameters |
| Проанализировать результаты аудита Lighthouse |
|
| Сравнить результаты аудита до и после |
|
| Получить рекомендации по оптимизации Core Web Vitals |
|
| Получить рекомендации по оптимизации ресурсов |
|
📚 Доступные ресурсы
Lighthouse MCP server предоставляет встроенные справочные ресурсы с основными руководствами и лучшими практиками:
Ресурс | Описание | URI |
| Пороговые значения Core Web Vitals |
|
| Методы оптимизации производительности и их влияние |
|
| Рекомендации по доступности WCAG 2.1 и проблемы |
|
| Лучшие практики SEO и возможности оптимизации |
|
| Лучшие практики веб-безопасности и уязвимости |
|
| Рекомендации по бюджету производительности по типам сайтов |
|
| Категории аудита Lighthouse и методы оценки |
|
| Руководства по оптимизации для конкретных фреймворков |
|
🎯 Стратегические подсказки
Подсказка | Описание | Параметры |
| Создать комплексный план улучшения производительности |
|
| Создать индивидуальные рекомендации по бюджету производительности |
|
| Сформировать рекомендации по улучшению SEO |
|
| Создать руководство по улучшению доступности |
|
🔧 Детали параметров подсказок
auditResults: JSON-результаты аудита из инструментов LighthousefocusArea: Конкретная категория для фокусировки ("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.
🔒 Безопасность
По вопросам безопасности обращайтесь к нашей Политике безопасности.
📞 Поддержка
🐛 Сообщения об ошибках: GitHub Issues
💬 Обсуждения: GitHub Discussions
📧 Электронная почта: security@codingrules.ai
🙏 Благодарности
Команде Google Lighthouse за отличный движок аудита
Anthropic за спецификацию Model Context Protocol
Сообществу открытого кода за постоянное вдохновение и вклад
Сделано с ❤️ 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