@enemyrr/mcp-server-pagespeed

基本能力

产品定位

mcp-server-pagespeed 是一个网页性能分析工具，旨在帮助开发者和 AI 模型快速评估和优化网页的加载性能。

核心功能

• 实时网页性能分析：通过 Google PageSpeed Insights API 提供实时的性能评分。
• 详细的加载体验指标：包括首次内容绘制（First Contentful Paint）和首次输入延迟（First Input Delay）等关键指标。
• 优先优化建议：提供前 5 条优化建议，包括标题、描述、潜在影响和当前值。
• 全面的错误处理：支持处理无效 URL、API 请求失败、连接问题等错误情况。
• TypeScript 支持：提供 TypeScript 类型支持，便于开发集成。

适用场景

• 开发者在开发过程中需要快速评估网页性能。
• AI 模型需要通过标准化接口获取网页性能数据。
• 团队在优化网站性能时需要详细的优化建议。

工具列表

• analyze_pagespeed：分析网页性能的工具，返回性能评分、加载体验指标和优化建议。

常见问题解答

• 如何解决无效 URL 错误？：确保输入的 URL 格式正确且可访问。
• API 请求失败如何处理？：检查网络连接和 API 密钥（如有）。
• 如何获取更详细的错误信息？：查看服务器返回的错误日志。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 克隆项目并安装依赖：

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

安装教程

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

注意：将 /absolute/path/to/ 替换为实际的项目路径。

调试方式

运行以下命令启动服务：

npx mcp-server-pagespeed

使用工具 analyze_pagespeed 进行网页性能分析：

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。