Lighthouse MCP
Lighthouse MCP Server
Ein Model Context Protocol (MCP)-Server, der umfassende Web-Performance-Audits und Analysefunktionen mithilfe von Google Lighthouse bereitstellt. Dieser Server ermöglicht LLMs und KI-Agenten, detaillierte Website-Leistungsbewertungen, Barrierefreiheits-Audits, SEO-Analysen, Sicherheitsprüfungen und Core-Web-Vitals-Überwachung durchzuführen.
🌟 Hauptfunktionen
🚀 Leistungsanalyse: Vollständige Lighthouse-Audits mit Core Web Vitals, Leistungswerten und Optimierungsempfehlungen
♿ Barrierefreiheits-Audits: WCAG-Konformitätsprüfung und Analyse des Barrierefreiheits-Scores
🔍 SEO-Analyse: Suchmaschinenoptimierungs-Audits und Empfehlungen zu Best Practices
🔒 Sicherheitsbewertung: HTTPS-, CSP- und Sicherheitslücken-Scans
📊 Ressourcenanalyse: Optimierungsmöglichkeiten für JavaScript, CSS, Bilder und Schriftarten
📱 Mobil vs. Desktop: Vergleichende Analyse über Geräte hinweg mit Drosselungsoptionen
⚡ Core Web Vitals: LCP-, INP-, CLS-Überwachung mit Schwellenwertprüfung
🎯 Leistungsbudgets: Benutzerdefinierte Leistungsschwellenwerte und Budgetüberwachung
🤖 Agenten-Browsing: Lighthouse-13-Audits zur Bewertung, wie gut eine Seite KI-Agenten bedient (WebMCP-Tools, Agenten-Barrierefreiheitsbaum, llms.txt)
🧩 Strukturierte Ausgabe: Jedes Tool deklariert ein
outputSchemaund gibt validiertesstructuredContentzurück, sodass Clients typisierte Daten erhalten, anstatt einen JSON-String parsen zu müssen📚 Referenzressourcen: Integrierte Richtlinien und Best Practices für Web-Performance, Barrierefreiheit, SEO und Sicherheit
Related MCP server: mcp-seo
🛠️ Voraussetzungen
Node.js 22.0.0 oder neuer
Chrome/Chromium-Browser (wird automatisch von Lighthouse verwaltet)
VS Code, Cursor, Windsurf, Claude Desktop oder ein anderer MCP-Client
🚀 Erste Schritte
Installieren Sie den Lighthouse MCP server mit Ihrem bevorzugten Client mithilfe einer der folgenden Konfigurationen:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}Persistente Chrome-Profile (Anmeldesitzungen)
Wenn Sie authentifizierte Sitzungen benötigen, starten Sie mit einem persistenten Chrome-Profil und führen Sie den Browser im sichtbaren Modus aus:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": [
"@danielsogl/lighthouse-mcp@latest",
"--profile-path",
"<profile-path>",
"--no-headless"
]
}
}
}Sie können zusätzliche Chrome-Flags mit --chrome-flag übergeben, z. B. --chrome-flag=--disable-gpu. Wenn der Flag-Wert mit -- beginnt und mit einem bekannten Optionsnamen übereinstimmt, bevorzugen Sie --chrome-flag=..., um zu vermeiden, dass er als Top-Level-Option geparst wird. Der Profilmodus deaktiviert das Zurücksetzen des Speichers durch Lighthouse, sodass Cookies und lokaler Speicher zwischen den Läufen erhalten bleiben. Wenn --user-data-dir auf ein fehlendes Verzeichnis verweist, wird es erstellt und als frisches Profil behandelt. Setzen Sie --profile-path auf den Profilpfad, der in chrome://version angezeigt wird (z. B. .../Default). Hinweis: Das Remote-Debugging von Chrome erfordert ein nicht standardmäßiges Benutzerdatenverzeichnis. Verwenden Sie daher ein dediziertes Profilverzeichnis anstelle des Systemstandards. Sie können --user-data-dir und --profile-directory auch separat übergeben, wenn Sie das bevorzugen. Das Anhängen mit --chrome-port allein erhält den Speicher nicht; fügen Sie ein Profil-Flag hinzu, um Sitzungen zu behalten.
CLI-Optionen
Unterstützte Laufzeit-Flags für den MCP-Server:
--profile-path <path>: Verwenden Sie den Profilpfad auschrome://version(leitet Benutzerdatenverzeichnis + Profilnamen automatisch ab)--user-data-dir <path>: Wiederverwenden eines Chrome-Profilverzeichnisses für persistente Sitzungen--profile-directory <name>: Auswählen eines Profils innerhalb des Benutzerdatenverzeichnisses--chrome-path <path>: Expliziter Pfad zur Chrome/Chromium-Ausführungsdatei (überschreibt die automatische Erkennung; berücksichtigt auch die UmgebungsvariableCHROME_PATH)--chrome-flag <flag>oder--chrome-flag=<flag>: Durchreichen zusätzlicher Chrome-Flags (wiederholbar)--chrome-port <port>oder--remote-debugging-port <port>: An eine vorhandene Chrome-Instanz anhängen, die mit aktiviertem Remote-Debugging gestartet wurde--headless: Headless-Modus erzwingen--no-headless: Headed-Modus erzwingen
Protokollierung
Lighthouse protokolliert nach stderr. Der Server belässt dies auf error, damit die Protokolle Ihres MCP-Clients nicht überflutet werden; setzen Sie LIGHTHOUSE_LOG_LEVEL beim Debuggen auf silent, info oder verbose (z. B. wenn Chrome nicht gestartet werden kann).
LIGHTHOUSE_LOG_LEVEL=verbose npx @danielsogl/lighthouse-mcp@latestWSL2 / Benutzerdefinierter Chrome-Pfad
Wenn die falsche Chrome-Binärdatei verwendet wird (z. B. Windows-Chrome anstelle der Linux-Binärdatei unter WSL2), legen Sie den Pfad explizit fest:
# 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@latestIn Ihrer MCP-Konfiguration:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest", "--chrome-path", "/usr/bin/google-chrome"]
}
}
}E2E-Smoke-Test (Profil)
Führen Sie ein echtes Audit mit einem persistenten Profil aus (verwenden Sie ein vorhandenes Profilverzeichnis und melden Sie sich bei Bedarf einmal an):
npm run smoke:profile -- --url https://example.com \
--profile-path "<profile-path>" \
--no-headlessE2E-Smoke-Test (An vorhandenes Chrome anhängen)
Starten Sie Chrome mit aktiviertem Remote-Debugging:
/path/to/GoogleChromeExecutable \
--remote-debugging-port=9222 \
--user-data-dir /path/to/chrome-profileErsetzen Sie /path/to/GoogleChromeExecutable durch den Chrome/Chromium-Binärpfad Ihrer Plattform.
Hängen Sie dann Lighthouse an diese Instanz an:
npm run smoke:profile -- --url https://example.com --chrome-port 9222Um den Speicher beim Anhängen zu erhalten, übergeben Sie den Profilpfad, damit Lighthouse Cookies/lokalen Speicher behält:
npm run smoke:profile -- --url https://example.com \
--chrome-port 9222 \
--profile-path "<profile-path>"Installation in VS Code
Sie können den Lighthouse MCP server auch über die VS-Code-CLI installieren:
# 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"]}'Nach der Installation ist der Lighthouse MCP server für die Verwendung mit Ihrem GitHub-Copilot-Agenten in VS Code verfügbar.
Installation in Cursor
Gehen Sie zu Cursor Settings → MCP → Add new MCP Server. Nennen Sie ihn „lighthouse", verwenden Sie den Typ command mit dem Befehl npx @danielsogl/lighthouse-mcp@latest:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}Installation in Windsurf
Befolgen Sie die Dokumentation zu Windsurf MCP. Verwenden Sie die folgende Konfiguration:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}Installation in Claude Desktop
Befolgen Sie die Anleitung zur MCP-Installation und verwenden Sie die folgende Konfiguration:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}🔧 Verfügbare Tools
Der Lighthouse MCP server stellt die folgenden Tools für eine umfassende Webanalyse bereit:
🏁 Audit-Tools
Tool | Beschreibung | Parameter |
| Ein umfassendes Lighthouse-Audit durchführen |
|
| Barrierefreiheits-Score und Empfehlungen abrufen |
|
| SEO-Analyse und Empfehlungen abrufen |
|
⚡ Performance-Tools
Tool | Beschreibung | Parameter |
| Gesamt-Performance-Score abrufen |
|
| Metriken für Core Web Vitals abrufen |
|
| Performance über Geräte hinweg vergleichen |
|
| Gegen Leistungsbudgets prüfen |
|
| LCP-Optimierungsmöglichkeiten finden |
|
🔍 Analyse-Tools
Tool | Beschreibung | Parameter |
| Nicht verwendeten JavaScript-Code finden |
|
| Alle Website-Ressourcen analysieren |
|
🔒 Sicherheits-Tools
Tool | Beschreibung | Parameter |
| Umfassendes Sicherheitsaudit durchführen |
|
💬 Verfügbare Prompts
Der Lighthouse MCP server enthält wiederverwendbare Prompts, die LLMs dabei helfen, strukturierte Analysen und Empfehlungen bereitzustellen:
📊 Analyse-Prompts
Prompt | Beschreibung | Parameter |
| Lighthouse-Auditergebnisse analysieren |
|
| Vorher/Nachher-Auditergebnisse vergleichen |
|
| Optimierungsempfehlungen für Core Web Vitals abrufen |
|
| Empfehlungen zur Ressourcenoptimierung abrufen |
|
📚 Verfügbare Ressourcen
Der Lighthouse MCP server bietet integrierte Referenzressourcen mit wichtigen Richtlinien und Best Practices:
Resource | Description | URI |
| Leistungsschwellenwerte für Core Web Vitals |
|
| Leistungsoptimierungstechniken und Auswirkungen |
|
| WCAG-2.1-Barrierefreiheitsrichtlinien und -probleme |
|
| SEO-Best-Practices und Optimierungsmöglichkeiten |
|
| Best Practices für Websicherheit und Schwachstellen |
|
| Empfehlungen für Leistungsbudgets nach Website-Typ |
|
| Lighthouse-Auditkategorien und Bewertungsmethoden |
|
| Framework-spezifische Optimierungsleitfäden |
|
🎯 Strategie-Prompts
Prompt | Description | Parameters |
| Umfassenden Plan zur Leistungsverbesserung erstellen |
|
| Benutzerdefinierte Empfehlungen für Leistungsbudgets erstellen |
|
| Empfehlungen zur SEO-Verbesserung generieren |
|
| Leitfaden zur Verbesserung der Barrierefreiheit erstellen |
|
🔧 Details zu Prompt-Parametern
auditResults: JSON-Auditergebnisse von Lighthouse-ToolsfocusArea: Bestimmte Kategorie, auf die fokussiert werden soll ("performance","accessibility","seo","best-practices","agentic-browsing")beforeAudit/afterAudit: Lighthouse-Auditergebnisse vor und nach ÄnderungenchangesImplemented: Beschreibung der zwischen Audits vorgenommenen ÄnderungencurrentMetrics: Aktuelle Leistungskennzahlen aus AuditstargetGoals: Spezifische Leistungsziele oder Geschäftszieletimeframe: Zeitplan für die Umsetzung von Verbesserungenframework: Frontend-Framework oder Technologie-Stackconstraints: Technische oder geschäftliche EinschränkungenwebsiteType: Art der Website (z. B. E-Commerce, Blog, Unternehmen)targetAudience: Zielgruppe oder MarktinformationencomplianceLevel: WCAG-Konformitätsstufe ("AA"oder"AAA")userGroups: Bestimmte Benutzergruppen, die für die Barrierefreiheit zu berücksichtigen sind
📋 Parameterdetails
Allgemeine Parameter
url(erforderlich): Die zu analysierende Website-URLdevice: Zielgerät ("desktop"oder"mobile", Standard:"desktop")includeDetails: Detaillierte Auditinformationen einschließen (Standard:false)throttling: Netzwerk-/CPU-Drosselung aktivieren (Standard:false)
Spezifische Parameter
categories: Zu prüfende Lighthouse-Kategorien (["performance", "accessibility", "best-practices", "seo", "agentic-browsing"])threshold: Benutzerdefinierte Schwellenwerte für Kennzahlen (z. B.{"lcp": 2.5, "inp": 200, "cls": 0.1})budget: Leistungsbudget-Grenzwerte (z. B.{"performanceScore": 90, "largestContentfulPaint": 2500})resourceTypes: Zu analysierende Ressourcentypen (["images", "javascript", "css", "fonts", "other"])minBytes: Mindestdateigrößen-Schwellenwert für die Analyse (Standard:2048)checks: Durchzuführende Sicherheitsprüfungen (["https", "csp", "hsts", "origin-isolation", "clickjacking", "trusted-types", "third-party-cookies", "deprecations"])
💡 Anwendungsbeispiele
Grundlegendes Leistungsaudit
// Get overall performance score
{
"tool": "get_performance_score",
"arguments": {
"url": "https://example.com",
"device": "mobile"
}
}Core-Web-Vitals-Analyse
// 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
}
}
}Sicherheitsbewertung
// Comprehensive security audit
{
"tool": "get_security_audit",
"arguments": {
"url": "https://example.com",
"checks": ["https", "csp", "hsts"]
}
}Ressourcenoptimierung
// Find optimization opportunities
{
"tool": "analyze_resources",
"arguments": {
"url": "https://example.com",
"resourceTypes": ["images", "javascript"],
"minSize": 1024
}
}Verwendung von Referenzressourcen
Auf integrierte Richtlinien und Best Practices zugreifen:
// 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"
}
}Verwendung von Prompts für die Analyse
// 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"
}
}🎯 Anwendungsfälle
Leistungsüberwachung: Automatisierte Leistungsverfolgung und Core-Web-Vitals-Überwachung
Barrierefreiheitskonformität: WCAG-2.1-Konformitätsprüfung und Anleitung zur Behebung
SEO-Optimierung: Technische SEO-Audits und Empfehlungen zur Suchmaschinenoptimierung
Sicherheitsbewertung: Schwachstellenscanning und Validierung von Sicherheits-Best-Practices
Ressourcenoptimierung: Bundle-Analyse und Identifizierung von Optimierungsmöglichkeiten
Leistungsbudgets: Automatisierte Leistungsbudget-Überwachung und -Benachrichtigung
CI/CD-Integration: Automatisierte Qualitätskontrollen und Erkennung von Leistungsregressionen
🏗️ Architektur
Der Server basiert auf:
Model Context Protocol SDK: Für die MCP-Server-Implementierung
Google Lighthouse: Für Web-Performance-Audits
Chrome Launcher: Für die Browser-Automatisierung
TypeScript: Für Typsicherheit und bessere Entwicklererfahrung
Zod: Für die Laufzeit-Schemavalidierung
🧪 Tests
npm run test:run # unit tests
npm run test:coverage # unit tests with coverage
npm run test:e2e # end-to-end testsDie End-to-End-Suite erstellt den Server, startet ihn über stdio mit einem echten MCP-Client und führt echte Lighthouse-Audits gegen eine Testseite durch, die über Loopback bereitgestellt wird. Dafür muss Chrome installiert sein; setzen Sie CHROME_PATH, wenn es sich an einem nicht standardmäßigen Ort befindet.
🤝 Beitragen
Beiträge sind willkommen! Bitte lesen Sie unseren Beitragsleitfaden für Details zu:
Codestil und Standards
Testanforderungen
Pull-Request-Prozess
Entwicklungseinrichtung
📜 Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die Datei LICENSE für Details.
🔒 Sicherheit
Bei Sicherheitsproblemen lesen Sie bitte unsere Sicherheitsrichtlinie.
📞 Support
🐛 Fehlerberichte: GitHub Issues
💬 Diskussionen: GitHub Discussions
📧 E-Mail: security@codingrules.ai
🙏 Danksagungen
Dem Google-Lighthouse-Team für die hervorragende Audit-Engine
Anthropic für die Model-Context-Protocol-Spezifikation
Der Open-Source-Community für kontinuierliche Inspiration und Beiträge
Erstellt mit ❤️ von 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