A
securityA
licenseA
qualityEnables AI models to analyze webpage performance using the Google PageSpeed Insights API, providing real-time performance scores and improvement suggestions.
Last updated -
1
6
8
MIT License
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
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
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
- -securityFlicense-qualityProvides 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 -27
- AsecurityAlicenseAqualityAllows 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 -219941MIT License
- -securityFlicense-qualityEnables AI tools to interact with your browser for enhanced frontend development, providing context-rich capabilities like API call analysis, screenshot capture, element inspection, and API testing with automatic authentication.Last updated -3