mcp server pagespeed

Local 2025-09-01 00:12:36 0
Browser Automation @enemyrr/mcp-server-pagespeed

Enables AI models to analyze webpage performance using the Google PageSpeed Insights API, providing real-time performance scores and improvement suggestions.

A Model Context Protocol server that provides Google PageSpeed Insights analysis. This server enables AI models to analyze webpage performance through a standardized interface.

Server Pagespeed MCP server

Installation & Setup for Cursor IDE

  1. Clone and build the project: 

    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:

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

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

Command-line Usage

Just run:

npx mcp-server-pagespeed

Available Tools

analyze_pagespeed

Analyze a webpage using Google PageSpeed Insights API.

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

The tool returns: - Overall performance score (0-100) - Loading experience metrics - First Contentful Paint - First Input Delay - Top 5 improvement suggestions with: - Title - Description - Potential impact - Current value

Features

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

Error Handling

The server provides detailed error messages for: - Invalid URLs - API request failures - Connection issues - Invalid tool calls

Contributing

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

License

MIT 

[
  {
    "description": "Analyzes a webpage using Google PageSpeed Insights API",
    "inputSchema": {
      "properties": {
        "url": {
          "description": "The URL to analyze",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "name": "analyze_pagespeed"
  }
]