Pagespeed

Provides Google PageSpeed Insights analysis via MCP for real-time performance data and optimization suggestions.

typescript

9

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can deploy and use a dedicated MCP server that analyzes webpage performance with Google PageSpeed Insights. It exposes a simple interface for AI models to request PageSpeed data, get actionable insights, and receive detailed loading metrics and optimization suggestions.

How to use

You can use this server from an MCP client by calling the analyze_pagespeed tool on a target URL. The server returns a performance score, loading metrics, and a prioritized list of improvements to optimize page performance.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Clone the project and install dependencies:

How to install

Build and run the server locally after cloning:

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

How to use the server (runtime options)

You have two straightforward ways to run the server locally.

npx mcp-server-pagespeed

Alternative local runtime (Cursor IDE integration)

If you configure Cursor IDE to load the built server, start it with the following command from a terminal that has your built files available.

node /absolute/path/to/mcp-server-pagespeed/build/index.js

Usage example with the MCP client tool

From your MCP client, you can invoke the pagespeed analyzer like this.

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

Available tools

analyze_pagespeed

Analyzes a webpage using the Google PageSpeed Insights API and returns the overall performance score, loading metrics, and top improvement suggestions with context like title, description, potential impact, and current values.