@enemyrr/mcp-server-pagespeed

基本能力

产品定位

enemyrr_mcp-server-pagespeed 是一个专注于网页性能分析的工具，旨在帮助开发者和 AI 模型快速评估网页的性能表现，并提供优化建议。

核心功能

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

适用场景

• 网页性能优化：开发者在开发或优化网页时，可以使用该工具快速评估性能并获取改进建议。
• AI 模型集成：AI 模型可以通过该服务的标准化接口获取网页性能数据，用于进一步的分析和决策。
• 自动化测试：在自动化测试流程中集成网页性能分析，确保网页性能符合标准。

工具列表

• analyze_pagespeed：
• 能力：使用 Google PageSpeed Insights API 分析网页性能，返回整体性能评分、加载体验指标和改进建议。

常见问题解答

• 错误处理：服务提供了详细的错误消息，帮助用户快速定位和解决问题。
• 贡献指南：欢迎通过 Pull Request 贡献代码，项目托管在 GitHub 上。

使用教程

使用依赖

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/ 替换为项目克隆和构建的实际路径。

调试方式

1. 运行以下命令启动服务：

npx mcp-server-pagespeed

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

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

1. 检查返回的性能数据和建议，确保服务正常运行。

许可证

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