https://github.com/enemyrr/mcp-server-pagespeed
https://github.com/enemyrr/mcp-server-pagespeed
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/enemyrr/mcp-server-pagespeed
- Owner: enemyrr
- License: mit
- Created: 2025-02-08T18:29:06.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-11T17:17:58.000Z (4 months ago)
- Last Synced: 2025-03-14T13:04:42.382Z (3 months ago)
- Language: JavaScript
- Size: 13.7 KB
- Stars: 1
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- mcp-index - PageSpeed - Analyze webpage performance using Google PageSpeed Insights to provide metrics and suggestions for optimization. (APIs and HTTP Requests)
README
# @enemyrr/mcp-server-pagespeed
A Model Context Protocol server that provides Google PageSpeed Insights analysis. This server enables AI models to analyze webpage performance through a standardized interface.
## Installation & Setup for Cursor IDE
1. Clone and build the project:
```bash
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 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`
> **Note**: Replace `/absolute/path/to/` with the actual path where you cloned and built the project.
## Command-line Usage
Just run:
```bash
npx mcp-server-pagespeed
```
## Available Tools
### analyze_pagespeed
Analyze a webpage using Google PageSpeed Insights API.
```typescript
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