PageSpeed MCP Server

MIT License
0
4
  • Linux
  • Apple

Integrations

  • Allows AI assistants to access Google's PageSpeed Insights API for detailed performance analysis of websites, including metrics like Core Web Vitals, performance scores, accessibility, best practices, and SEO audits

PageSpeed MCP Server

A Model Context Protocol (MCP) server that extends AI assistant capabilities with PageSpeed Insights functionality. This server acts as a bridge between AI models and Google's PageSpeed Insights API, enabling detailed performance analysis of websites.

Overview

The PageSpeed MCP server is designed to enhance AI assistants' capabilities by allowing them to perform comprehensive web performance analysis. When integrated, AI models can request and interpret detailed performance metrics, Core Web Vitals, and other critical web performance data for any given URL.

Installation

Installing via Smithery

To install PageSpeed Server for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install pagespeed-mcp-server

Configuration

Add the PageSpeed MCP to your AI assistant's(claude in this case) configuration file:

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

Detailed Capabilities

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 checks

SEO Analysis

  • Meta description validation
  • Robots.txt validation
  • Structured data validation
  • Crawlable links verification
  • Meta tags assessment
  • Mobile friendliness

Accessibility Audits

  • ARIA attribute validation
  • Color contrast checking
  • Heading hierarchy analysis
  • Alt text verification
  • Focus management assessment
  • Keyboard navigation testing

Resource Optimization

  • Image optimization suggestions
  • JavaScript bundling analysis
  • CSS optimization recommendations
  • Cache policy validation
  • Resource minification checks
  • 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 audit */ }, "seo": { /* SEO findings */ } }, "audits": { // Detailed audit results for each category }, "timing": { // Performance timing data }, "stackPacks": { // Technology-specific advice } } }

Advanced Usage

Custom Configuration

You can customize the PageSpeed analysis by providing additional parameters:

{ "strategy": "mobile", // or "desktop" "category": ["performance", "accessibility", "best-practices", "seo"], "locale": "en", "threshold": { "performance": 90, "accessibility": 100, "best-practices": 90, "seo": 90 } }

Error Handling

The MCP server includes robust error handling for:

  • Invalid URLs
  • Network timeouts
  • API rate limiting
  • Invalid parameters
  • Server-side errors

Requirements

Network Requirements

  • Stable internet connection
  • Access to Google's PageSpeed Insights API

Platform Support

  • Windows (x64, x86)
  • Linux (x64)
  • macOS (x64, arm64)

Integration Examples

Basic Integration

const PageSpeedMCP = require('pagespeed-mcp-server'); const mcp = new PageSpeedMCP(); await mcp.analyze('https://example.com');

With Custom Options

const results = await mcp.analyze('https://example.com', { strategy: 'mobile', categories: ['performance', 'accessibility'], locale: 'en-US' });

Troubleshooting

Common Issues

  1. Connection Timeouts
    • Check internet connectivity
  2. API Rate Limiting
    • Use API key for higher limits
  3. Memory Issues
    • Adjust Node.js memory limits

Development

Building from Source

git clone https://github.com/phialsbasement/mcp-pagespeed-server cd mcp-pagespeed-server npm install npm run build

Running Tests

npm run test

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

Support

Getting Help

  • GitHub Issues: Report bugs and feature requests

License

MIT License - See LICENSE file for details

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Acts as a bridge between AI models and Google's PageSpeed Insights API, enabling detailed performance analysis of websites.

  1. Overview
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Configuration
      1. Detailed Capabilities
        1. Performance Metrics Analysis
        2. Best Practices Assessment
        3. SEO Analysis
        4. Accessibility Audits
        5. Resource Optimization
      2. API Response Structure
        1. Advanced Usage
          1. Custom Configuration
          2. Error Handling
        2. Requirements
          1. Network Requirements
          2. Platform Support
        3. Integration Examples
          1. Basic Integration
          2. With Custom Options
        4. Troubleshooting
          1. Common Issues
        5. Development
          1. Building from Source
          2. Running Tests
          3. Contributing
        6. Support
          1. Getting Help
        7. License

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            Enables web content scanning and analysis by fetching, analyzing, and extracting information from web pages using tools like page fetching, link extraction, site crawling, and more.
            Last updated -
            6
            3
            TypeScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
            Last updated -
            2
            5,133
            334
            JavaScript
            MIT License
            • Apple
            • Linux
          • A
            security
            A
            license
            A
            quality
            Enables AI models to analyze webpage performance using the Google PageSpeed Insights API, providing real-time performance scores and improvement suggestions.
            Last updated -
            1
            7
            1
            JavaScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            A browser monitoring and interaction tool that enables AI applications to capture and analyze browser data through a Chrome extension, supporting functions like console monitoring, screenshots, DOM analysis, and website auditing.
            Last updated -
            1
            JavaScript
            MIT License

          View all related MCP servers

          ID: tgfbq4e51o