Pagespeed MCP Server

🚀 PageSpeed MCP Server

A Model Context Protocol (MCP) server that enhances the capabilities of AI assistants, integrating PageSpeed Insights functionality. This server acts as a bridge between AI models and Google's 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 performance analysis. Once integrated, AI models can request and parse detailed performance metrics, Core Web Vitals, and other important web performance data for a specified URL.

📦 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

📚 Documentation

Configuration

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

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

Detailed 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
• Image Aspect Ratio Analysis
• Link Security Check

SEO Analysis

• Meta Description Validation
• Robots.txt File Validation
• Structured Data Validation
• Crawlable Link Validation
• Meta Tag Evaluation
• Mobile-Friendliness Detection

Accessibility Audit

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

Resource Optimization

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

API Response Structure

The MCP server provides detailed JSON responses, including:

{
    "lighthouseResult": {
        "categories": {
            "performance": { /* Performance Metrics */ },
            "accessibility": { /* Accessibility Results */ },
            "best-practices": { /* Best Practices Assessment */ },
            "seo": { /* SEO Analysis */ }
        },
        "details": {
            "performanceMetrics": [/* Performance Metrics Details */],
            "accessibilityIssues": [/* Accessibility Issues */],
            "optimizationSuggestions": [/* Optimization Suggestions */]
        }
    }
}

Advanced Usage

Custom Configuration

Add custom settings to the configuration file:

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

Error Handling

Handle potential errors:

try {
    const result = await pagespeed.analyze(url);
    console.log(result);
} catch (error) {
    console.error("Analysis failed:", error.message);
}

Requirements

• Platform Support: Supports Windows, Linux, and macOS systems.
• Node.js Version: Requires Node.js 14 or higher.

Getting Help

For support, please visit GitHub Issues to report issues and feature requests.

📄 License

MIT License - See the LICENSE file for details.