@enemyrr/mcp-server-pagespeed

一个提供 Google PageSpeed Insights 分析的 Model Context Protocol 服务器。该服务器通过标准化接口使 AI 模型能够分析网页性能。

安装与设置（针对 Cursor IDE）

1. 克隆并构建项目：

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

1. 在 Cursor IDE 设置中添加服务器：
   • 打开命令面板（Cmd/Ctrl + Shift + P）
   • 搜索 "MCP: Add Server"
   • 填写字段：
     • 名称：pagespeed
     • 类型：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）
• 加载体验指标
  • 首次内容绘制
  • 首次输入延迟
• 前 5 条改进建议，包括：
  • 标题
  • 描述
  • 潜在影响
  • 当前值

特性

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

错误处理

服务器为以下情况提供了详细的错误信息：

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

贡献

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

许可证

MIT