Lighthouse MCP Server

🚀 Lighthouse MCP Server

A Model Context Protocol (MCP) server that uses Google Lighthouse to offer comprehensive web performance auditing and analysis. It enables LLMs and AI agents to conduct detailed website performance assessments, accessibility audits, SEO analysis, security checks, and Core Web Vitals monitoring.

🚀 Quick Start

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

# 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"]}'

Install in Cursor

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

Install in Windsurf

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

Install in Claude Desktop

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

✨ 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

📦 Installation

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

💻 Usage Examples

Basic Usage

Basic Performance Audit

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

Advanced Usage

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

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

📚 Documentation

Available Tools

Audit Tools

Performance Tools

Analysis Tools

Security Tools

Available Prompts

Analysis Prompts

Available Resources

Strategy Prompts

Prompt Parameter Details

• auditResults: JSON audit results from Lighthouse tools
• focusArea: Specific category to focus on ("performance", "accessibility", "seo", "best-practices", "pwa")
• beforeAudit / afterAudit: Lighthouse audit results before and after changes
• changesImplemented: Description of changes made between audits
• currentMetrics: Current performance metrics from audits
• targetGoals: Specific performance targets or business goals
• timeframe: Timeline for implementing improvements
• framework: Frontend framework or technology stack
• constraints: Technical or business constraints
• websiteType: Type of website (e.g., e-commerce, blog, corporate)
• targetAudience: Target audience or market information
• complianceLevel: WCAG compliance level ("AA" or "AAA")
• userGroups: Specific user groups to consider for accessibility

Parameter Details

Common Parameters

• url (required): The website URL to analyze
• device: 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"])

🎯 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

🔧 Technical Details

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