Enemyrr MCP Server Pagespeed

🚀 @enemyrr/mcp-server-pagespeed

A Model Context Protocol (MCP) server that provides Google PageSpeed Insights analysis. This server enables AI models to analyze web page performance through a unified interface.

🚀 Quick Start

📦 Installation

In Cursor IDE

1. Clone the project and build it:

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

2. Add the server in Cursor IDE settings:
   • Open the command palette (Cmd/Ctrl + Shift + P).
   • Search for "MCP: Add Server".
   • Fill in the fields:
     • Name: pagespeed
     • Type: command
     • Command: node /absolute/path/to/mcp-server-pagespeed/build/index.js

⚠️ Important Note

Replace /absolute/path/to/ with the actual path where you cloned and built the project.

Command Line Usage

Run directly:

npx mcp-server-pagespeed

💻 Usage Examples

Basic Usage

analyze_pagespeed

Analyze a web page using the Google PageSpeed Insights API.

use_mcp_tool({
  server_name: "pagespeed",
  tool_name: "analyze_pagespeed",
  arguments: {
    url: "https://example.com"
  }
});

This tool returns:

• Overall performance score (0-100)
• Loading experience metrics
  • First Contentful Paint (FCP)
  • First Input Delay (FID)
• Top 5 improvement suggestions, including:
  • Title
  • Description
  • Potential impact
  • Current value

✨ Features

• Real-time web page performance analysis
• Detailed loading experience metrics
• Prioritized improvement suggestions
• Comprehensive error handling
• TypeScript support

🔧 Technical Details

Error Handling

The server provides detailed error information for the following situations:

• Invalid URL
• API request failure
• Connection issues
• Invalid tool calls

🤝 Contribution Guide

Contributions are welcome! Please feel free to submit a Pull Request to https://github.com/enemyrr/mcp-server-pagespeed

📄 License

MIT