@enemyrr/mcp-server-pagespeed

一个提供 Google PageSpeed Insights 分析的模型上下文协议服务器。该服务器使 AI 模型能够通过标准化接口分析网页性能。

<a href="https://glama.ai/mcp/servers/wes81w8il2"><img width="380" height="200" src="https://glama.ai/mcp/servers/wes81w8il2/badge" alt="Server Pagespeed MCP server" /></a>

Cursor IDE 的安装与设置

1. 克隆并构建项目：

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

2. 在 Cursor IDE 设置中添加服务器：
   • 打开命令面板 (Cmd/Ctrl + Shift + P)
   • 搜索 "MCP: Add Server"
   • 填写字段：
     • Name: pagespeed
     • Type: command
     • Command: node /absolute/path/to/mcp-server-pagespeed/build/index.js

注意: 将 /absolute/path/to/ 替换为您克隆和构建项目的实际路径。

命令行用法

只需运行：

npx mcp-server-pagespeed

可用工具

analyze_pagespeed

使用 Google PageSpeed Insights API 分析网页。

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

该工具返回：

• 总体性能得分 (0-100)
• 加载体验指标
  • 首次内容绘制 (First Contentful Paint)
  • 首次输入延迟 (First Input Delay)
• 前 5 个改进建议，包括：
  • 标题
  • 描述
  • 潜在影响
  • 当前值

特性

• 实时网页性能分析
• 详细的加载体验指标
• 优先排序的改进建议
• 完善的错误处理
• TypeScript 支持

错误处理

服务器提供详细的错误消息，用于：

• 无效的 URL
• API 请求失败
• 连接问题
• 无效的工具调用

贡献

欢迎贡献！请随时提交 Pull Request 到 https://github.com/enemyrr/mcp-server-pagespeed

许可证

MIT