Phialsbasement Pagespeed MCP Server

🚀 PageSpeed MCP Server

A Model Context Protocol (MCP) server that enhances the capabilities of AI assistants, integrating Google's PageSpeed Insights functionality. This server serves as a bridge between AI models and the PageSpeed Insights API, enabling detailed analysis of website performance.

🚀 Quick Start

PageSpeed MCP Server aims to enhance the capabilities of AI assistants, enabling them to perform comprehensive web page performance analysis. After integration, AI models can request and parse detailed performance metrics, Core Web Vitals, and other key data for specified URLs.

📦 Installation

Installation via Smithery

Automatically install the PageSpeed server for Claude Desktop through Smithery:

npx -y @smithery/cli install mcp-pagespeed-server --client claude

Manual Installation

npm install pagespeed-mcp-server

🛠️ Configuration

Add PageSpeed MCP to the configuration file of the AI assistant (Claude in this example):

{
    "pagespeed": {
        "command": "node",
        "args": ["path/to/mcp-pagespeed-server/dist/index.js"]
    }
}

✨ Features

Performance Metrics Analysis

• First Contentful Paint (FCP)
• Largest Contentful Paint (LCP)
• Time to Interactive (TTI)
• Total Blocking Time (TBT)
• Cumulative Layout Shift (CLS)
• Speed Index
• Time to First Byte (TTFB)

Best Practices Assessment

• HTTPS Usage
• JavaScript Error Monitoring
• Browser Console Warnings
• Deprecated API Usage Check
• Image Aspect Ratio Analysis
• Link Security Check

SEO Analysis

• Meta Description Validation
• robots.txt Validation
• Structured Data Validation
• Crawlable Link Verification
• Meta Tag Evaluation
• Mobile Friendliness Detection

Accessibility Audit

• ARIA Attribute Validation
• Color Contrast Check
• Heading Tag Hierarchy Analysis
• Alt Text Validation
• Focus Management Evaluation
• Keyboard Navigation Test

Resource Optimization

• Image Optimization Recommendations
• JavaScript Bundling Analysis
• CSS Optimization Suggestions
• Cache Strategy Validation
• Resource Minimization Check
• Render-Blocking Resource Identification

📚 Documentation

API Response Structure

The MCP server provides detailed JSON responses, including:

{
    "lighthouseResult": {
        "categories": {
            "performance": { /* Performance metrics */ },
            "accessibility": { /* Accessibility results */ },
            "best-practices": { /* Best practices audit */ },
            "seo": { /* SEO results */ }
        },
        "audits": {
            // Detailed audit results for each category
        },
        "timing": {
            // Performance timing data
        },
        "stackPacks": {
            // Technology-specific recommendations
        }
    }
}

🆘 Support

Get Help

• GitHub Issues: Report bugs and feature requests

📄 License

MIT License - See the LICENSE file for details.