PageSpeed MCP Server

基本能力

产品定位

PageSpeed MCP Server 是一个专为 AI 助手设计的性能分析工具，通过集成 Google PageSpeed Insights API，提供详细的网站性能分析和优化建议。

核心功能

1. 性能指标分析：包括首次内容绘制 (FCP)、最大内容绘制 (LCP)、交互时间 (TTI)、总阻塞时间 (TBT)、累积布局偏移 (CLS)、速度指数和首次字节时间 (TTFB)。
2. 最佳实践评估：检查 HTTPS 使用、JavaScript 错误监控、浏览器控制台警告、废弃 API 使用、图像宽高比分析和链接安全性检查。
3. SEO 分析：验证元描述、robots.txt、结构化数据、可爬取链接、元标签评估和移动设备友好性。
4. 可访问性审计：验证 ARIA 属性、颜色对比、标题层次结构、替代文本、焦点管理和键盘导航测试。
5. 资源优化：提供图像优化建议、JavaScript 捆绑分析、CSS 优化建议、缓存策略验证、资源压缩检查和渲染阻塞资源识别。

适用场景

1. 网站性能优化：帮助开发者和团队分析网站性能瓶颈并提供优化建议。
2. SEO 优化：通过 SEO 分析工具提升网站在搜索引擎中的排名。
3. 可访问性改进：确保网站符合可访问性标准，提升用户体验。
4. 开发效率提升：集成到 AI 助手中，自动化性能分析和报告生成。

工具列表

1. PageSpeed Insights API：提供详细的性能指标和优化建议。
2. 自定义配置工具：支持按需配置分析策略（移动或桌面）、类别（性能、可访问性、最佳实践、SEO）和语言。
3. 错误处理工具：处理无效 URL、网络超时、API 速率限制和服务器端错误。

常见问题解答

1. 连接超时：检查网络连接是否稳定。
2. API 速率限制：使用 API 密钥以提高限制。
3. 内存问题：调整 Node.js 内存限制。

使用教程

使用依赖

1. Node.js：确保已安装 Node.js。
2. 稳定互联网连接：确保可以访问 Google PageSpeed Insights API。

安装教程

通过 Smithery 安装

npx -y @smithery/cli install mcp-pagespeed-server --client claude

手动安装

npm install pagespeed-mcp-server

配置

在 AI 助手的配置文件中添加以下内容：

{
    "pagespeed": {
        "command": "node",
        "args": ["path/to/mcp-pagespeed-server/dist/index.js"]
    }
}

调试方式

1. 运行测试：

npm run test

1. 查看日志：检查服务器日志以识别潜在问题。
2. 验证 API 访问：确保可以正常访问 PageSpeed Insights API。

许可证

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