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

Connection Timeouts
- Check internet connectivity
API Rate Limiting
- Use API key for higher limits
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

Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Create a Pull Request

Support

Getting Help

GitHub Issues: Report bugs and feature requests

License

MIT License - See LICENSE file for details

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

Related MCP Servers

MCP Server Pagespeed
enemyrr
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
4
6
JavaScript
MIT License
SEO AI Assistant
ccnn2509
-
security
F
license
-
quality
Provides SEO automation with tools for keyword research, SERP analysis, and competitor analysis through Google Ads API integration, enabling AI assistants to access these capabilities via MCP.
Last updated -
21
JavaScript
lighthouse-mcp
priyankark
A
security
A
license
A
quality
Allows AI assistants such as Cursor/Cline/GitHub Copilot to use Google's lighthouse tool to measure perf metrics for your webpage. You can then run an agentic loop and get the assistants to optimize those metrics!
Last updated -
2
504
24
JavaScript
MIT License
Semrush MCP Server
metehan777
-
security
F
license
-
quality
Provides AI assistants with access to Semrush SEO API functionality including domain analytics, keyword research, backlink analysis, and competitor insights.
Last updated -
5
TypeScript

View all related MCP servers

PageSpeed MCP Server