Lighthouse MCP Server
by
Provides comprehensive web performance, accessibility, SEO, and security audits using Google Lighthouse, enabling AI agents to evaluate and improve websites.
Lighthouse MCP Server Overview
What is Lighthouse MCP Server about?
Lighthouse MCP Server delivers full‑stack website analysis through Google Lighthouse. It runs audits for performance, accessibility, best practices, SEO, and progressive web app readiness, exposing the results as tools, prompts, and reference resources that AI agents can invoke.
How to use Lighthouse MCP Server?
- Install the server via an MCP client (VS Code, Cursor, Windsurf, Claude Desktop, etc.) using the provided configuration. Example for VS Code:
{ "mcpServers": { "lighthouse": { "command": "npx", "args": ["-y", "@danielsogl/lighthouse-mcp@latest"] } } } - Invoke tools by sending JSON payloads that specify the tool name and arguments, e.g.,
get_performance_scorewith aurlanddevice. - Leverage prompts to transform raw audit data into actionable recommendations, such as
create-performance-planoranalyze-audit-results. - Access built‑in resources via URIs like
lighthouse://performance/core-web-vitals-thresholdsfor guidelines and best‑practice documentation.
Key features of Lighthouse MCP Server
- Full Lighthouse audit covering performance, accessibility, SEO, best practices, and PWA.
- Dedicated tools for scores, Core Web Vitals, budget checks, resource analysis, and security audits.
- Prompt library for structured analysis, optimization plans, and comparative reporting.
- Reference resources with standards (WCAG, SEO best practices, security guidelines) accessible via custom URIs.
- Device‑aware scanning (desktop / mobile) with optional throttling.
- Support for performance budgets and custom metric thresholds.
- Easy integration into CI/CD pipelines and AI‑driven workflows.
Use cases of Lighthouse MCP Server
- Continuous performance monitoring – automate Lighthouse runs in CI to enforce performance gates.
- Accessibility compliance checks – generate WCAG audit reports and remediation steps for auditors.
- SEO health audits – extract technical SEO issues and receive optimization recommendations.
- Security validation – run HTTPS, CSP, HSTS, and vulnerability checks before production releases.
- Resource optimization – identify unused JavaScript, oversized images, and other waste.
- Performance budgeting – define and enforce budget limits for load time, LCP, etc.
- AI‑assisted improvement plans – feed audit results to LLMs using built‑in prompts for detailed action plans.
FAQ from the Lighthouse MCP Server
Q: Which Node.js version is required? A: Node 22.0.0 or newer.
Q: Do I need to install Chrome manually? A: No. The server uses Chrome Launcher, which downloads and manages a suitable Chromium version automatically.
Q: Can I run the server on a remote CI machine? A: Yes. The MCP configuration works on any environment with Node 22+ and network access.
Q: How do I customize performance budgets?
A: Use the check_performance_budget tool with a budget argument, e.g., { "performanceScore": 90, "largestContentfulPaint": 2500 }.
Q: Is there support for custom prompts? A: The server includes a set of reusable prompts; you can extend them by defining additional prompt templates in your MCP client.
Q: Where can I find the source code and contribute? A: The repository is at https://github.com/danielsogl/lighthouse-mcp-server. Contributions are welcome via pull requests.
Lighthouse MCP Server's README
Lighthouse MCP Server
A Model Context Protocol (MCP) server that provides comprehensive web performance auditing and analysis capabilities using Google Lighthouse. This server enables LLMs and AI agents to perform detailed website performance assessments, accessibility audits, SEO analysis, security checks, and Core Web Vitals monitoring.
🌟 Key Features
- 🚀 Performance Analysis: Complete Lighthouse audits with Core Web Vitals, performance scores, and optimization recommendations
- ♿ Accessibility Audits: WCAG compliance checking and accessibility score analysis
- 🔍 SEO Analysis: Search engine optimization audits and best practice recommendations
- 🔒 Security Assessment: HTTPS, CSP, and security vulnerability scanning
- 📊 Resource Analysis: JavaScript, CSS, image, and font optimization opportunities
- 📱 Mobile vs Desktop: Comparative analysis across devices with throttling options
- ⚡ Core Web Vitals: LCP, FID, CLS monitoring with threshold checking
- 🎯 Performance Budgets: Custom performance thresholds and budget monitoring
- 📚 Reference Resources: Built-in guidelines and best practices for web performance, accessibility, SEO, and security
🛠️ Requirements
- Node.js 22.0.0 or newer
- Chrome/Chromium browser (automatically managed by Lighthouse)
- VS Code, Cursor, Windsurf, Claude Desktop, or any other MCP client
🚀 Getting Started
Install the Lighthouse MCP server with your preferred client using one of the configurations below:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}
Install in VS Code
You can also install the Lighthouse MCP server using the VS Code CLI:
# 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"]}'
After installation, the Lighthouse MCP server will be available for use with your GitHub Copilot agent in VS Code.
Install in Cursor
Go to Cursor Settings → MCP → Add new MCP Server. Name it "lighthouse", use command type with the command npx @danielsogl/lighthouse-mcp@latest:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}
Install in Windsurf
Follow the Windsurf MCP documentation. Use the following configuration:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}
Install in Claude Desktop
Follow the MCP install guide, use the following configuration:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["@danielsogl/lighthouse-mcp@latest"]
}
}
}
🔧 Available Tools
The Lighthouse MCP server provides the following tools for comprehensive web analysis:
🏁 Audit Tools
| Tool | Description | Parameters |
|---|---|---|
run_audit |
Run a comprehensive Lighthouse audit | url, categories?, device?, throttling? |
get_accessibility_score |
Get accessibility score and recommendations | url, device?, includeDetails? |
get_seo_analysis |
Get SEO analysis and recommendations | url, device?, includeDetails? |
check_pwa_readiness |
Check Progressive Web App readiness | url, device?, includeDetails? |
⚡ Performance Tools
| Tool | Description | Parameters |
|---|---|---|
get_performance_score |
Get overall performance score | url, device? |
get_core_web_vitals |
Get Core Web Vitals metrics | url, device?, includeDetails?, threshold? |
compare_mobile_desktop |
Compare performance across devices | url, categories?, throttling?, includeDetails? |
check_performance_budget |
Check against performance budgets | url, device?, budget |
get_lcp_opportunities |
Find LCP optimization opportunities | url, device?, includeDetails?, threshold? |
🔍 Analysis Tools
| Tool | Description | Parameters |
|---|---|---|
find_unused_javascript |
Find unused JavaScript code | url, device?, minBytes?, includeSourceMaps? |
analyze_resources |
Analyze all website resources | url, device?, resourceTypes?, minSize? |
🔒 Security Tools
| Tool | Description | Parameters |
|---|---|---|
get_security_audit |
Perform comprehensive security audit | url, device?, checks? |
💬 Available Prompts
The Lighthouse MCP server includes reusable prompts that help LLMs provide structured analysis and recommendations:
📊 Analysis Prompts
| Prompt | Description | Parameters |
|---|---|---|
analyze-audit-results |
Analyze Lighthouse audit results | auditResults, focusArea? |
compare-audits |
Compare before/after audit results | beforeAudit, afterAudit, changesImplemented? |
optimize-core-web-vitals |
Get Core Web Vitals optimization recommendations | coreWebVitals, framework?, constraints? |
optimize-resources |
Get resource optimization recommendations | resourceAnalysis, loadingStrategy?, criticalUserJourneys? |
📚 Available Resources
The Lighthouse MCP server provides built-in reference resources with essential guidelines and best practices:
| Resource | Description | URI |
|---|---|---|
core-web-vitals-thresholds |
Core Web Vitals performance thresholds | lighthouse://performance/core-web-vitals-thresholds |
optimization-techniques |
Performance optimization techniques and impact | lighthouse://performance/optimization-techniques |
wcag-guidelines |
WCAG 2.1 accessibility guidelines and issues | lighthouse://accessibility/wcag-guidelines |
seo-best-practices |
SEO best practices and optimization opportunities | lighthouse://seo/best-practices |
security-best-practices |
Web security best practices and vulnerabilities | lighthouse://security/best-practices |
budget-guidelines |
Performance budget recommendations by site type | lighthouse://performance/budget-guidelines |
categories-scoring |
Lighthouse audit categories and scoring methods | lighthouse://audits/categories-scoring |
framework-guides |
Framework-specific optimization guides | lighthouse://frameworks/optimization-guides |
🎯 Strategy Prompts
| Prompt | Description | Parameters |
|---|---|---|
create-performance-plan |
Generate comprehensive performance improvement plan | currentMetrics, targetGoals?, timeframe? |
create-performance-budget |
Create custom performance budget recommendations | currentMetrics, businessGoals?, userBase? |
seo-recommendations |
Generate SEO improvement recommendations | seoAudit, websiteType?, targetAudience? |
accessibility-guide |
Create accessibility improvement guide | accessibilityAudit, complianceLevel?, userGroups? |
🔧 Prompt Parameter Details
auditResults: JSON audit results from Lighthouse toolsfocusArea: Specific category to focus on ("performance","accessibility","seo","best-practices","pwa")beforeAudit/afterAudit: Lighthouse audit results before and after changeschangesImplemented: Description of changes made between auditscurrentMetrics: Current performance metrics from auditstargetGoals: Specific performance targets or business goalstimeframe: Timeline for implementing improvementsframework: Frontend framework or technology stackconstraints: Technical or business constraintswebsiteType: Type of website (e.g., e-commerce, blog, corporate)targetAudience: Target audience or market informationcomplianceLevel: WCAG compliance level ("AA"or"AAA")userGroups: Specific user groups to consider for accessibility
📋 Parameter Details
Common Parameters
url(required): The website URL to analyzedevice: Target device ("desktop"or"mobile", default:"desktop")includeDetails: Include detailed audit information (default:false)throttling: Enable network/CPU throttling (default:false)
Specific Parameters
categories: Lighthouse categories to audit (["performance", "accessibility", "best-practices", "seo", "pwa"])threshold: Custom thresholds for metrics (e.g.,{"lcp": 2.5, "fid": 100, "cls": 0.1})budget: Performance budget limits (e.g.,{"performanceScore": 90, "largestContentfulPaint": 2500})resourceTypes: Resource types to analyze (["images", "javascript", "css", "fonts", "other"])minBytes: Minimum file size threshold for analysis (default:2048)checks: Security checks to perform (["https", "mixed-content", "csp", "hsts", "vulnerabilities"])
💡 Usage Examples
Basic Performance Audit
// Get overall performance score
{
"tool": "get_performance_score",
"arguments": {
"url": "https://example.com",
"device": "mobile"
}
}
Core Web Vitals Analysis
// 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,
"fid": 100,
"cls": 0.1
}
}
}
Security Assessment
// Comprehensive security audit
{
"tool": "get_security_audit",
"arguments": {
"url": "https://example.com",
"checks": ["https", "csp", "hsts"]
}
}
Resource Optimization
// Find optimization opportunities
{
"tool": "analyze_resources",
"arguments": {
"url": "https://example.com",
"resourceTypes": ["images", "javascript"],
"minSize": 1024
}
}
Using Reference Resources
Access built-in guidelines and best practices:
// 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"
}
}
Using Prompts for Analysis
// 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"
}
}
🎯 Use Cases
- Performance Monitoring: Automated performance tracking and Core Web Vitals monitoring
- Accessibility Compliance: WCAG 2.1 compliance checking and remediation guidance
- SEO Optimization: Technical SEO audits and search engine optimization recommendations
- Security Assessment: Vulnerability scanning and security best practice validation
- Resource Optimization: Bundle analysis and optimization opportunity identification
- Performance Budgets: Automated performance budget monitoring and alerting
- CI/CD Integration: Automated quality gates and performance regression detection
🏗️ Architecture
The server is built using:
- Model Context Protocol SDK: For MCP server implementation
- Google Lighthouse: For web performance auditing
- Chrome Launcher: For browser automation
- TypeScript: For type safety and better developer experience
- Zod: For runtime schema validation
🤝 Contributing
Contributions are welcome! Please read our Contributing Guide for details on:
- Code style and standards
- Testing requirements
- Pull request process
- Development setup
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
🔒 Security
For security issues, please see our Security Policy.
📞 Support
- 🐛 Bug Reports: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📧 Email: security@codingrules.ai
🙏 Acknowledgments
- Google Lighthouse team for the excellent auditing engine
- Anthropic for the Model Context Protocol specification
- The open source community for continuous inspiration and contributions
Built with ❤️ by Daniel Sogl
Lighthouse MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Similar MCP Servers like Lighthouse MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Git
Officialby modelcontextprotocol
A Model Context Protocol server for Git repository interaction and automation.
Zed
OfficialClientby zed-industries
A high‑performance, multiplayer code editor designed for speed and collaboration.
Everything
Officialby modelcontextprotocol
Model Context Protocol Servers
Time
Officialby modelcontextprotocol
A Model Context Protocol server that provides time and timezone conversion capabilities.
Cline
OfficialClientby cline
An autonomous coding assistant that can create and edit files, execute terminal commands, and interact with a browser directly from your IDE, operating step‑by‑step with explicit user permission.
Context7 MCP
Officialby upstash
Provides up-to-date, version‑specific library documentation and code examples directly inside LLM prompts, eliminating outdated information and hallucinated APIs.
Daytona
by daytonaio
Provides a secure, elastic infrastructure that creates isolated sandboxes for running AI‑generated code with sub‑90 ms startup, unlimited persistence, and OCI/Docker compatibility.
Continue
OfficialClientby continuedev
Enables faster shipping of code by integrating continuous AI agents across IDEs, terminals, and CI pipelines, offering chat, edit, autocomplete, and customizable agent workflows.
GitHub MCP Server
by github
Connects AI tools directly to GitHub, enabling natural‑language interactions for repository browsing, issue and pull‑request management, CI/CD monitoring, code‑security analysis, and team collaboration.