基本能力
产品定位
PageSpeed MCP Server 是一个专为 AI 助手设计的性能分析工具,通过集成 Google PageSpeed Insights API,提供详细的网站性能分析和优化建议。
核心功能
- 性能指标分析:包括首次内容绘制 (FCP)、最大内容绘制 (LCP)、交互时间 (TTI)、总阻塞时间 (TBT)、累积布局偏移 (CLS)、速度指数和首次字节时间 (TTFB)。
- 最佳实践评估:检查 HTTPS 使用、JavaScript 错误监控、浏览器控制台警告、废弃 API 使用、图像宽高比分析和链接安全性检查。
- SEO 分析:验证元描述、robots.txt、结构化数据、可爬取链接、元标签评估和移动设备友好性。
- 可访问性审计:验证 ARIA 属性、颜色对比、标题层次结构、替代文本、焦点管理和键盘导航测试。
- 资源优化:提供图像优化建议、JavaScript 捆绑分析、CSS 优化建议、缓存策略验证、资源压缩检查和渲染阻塞资源识别。
适用场景
- 网站性能优化:帮助开发者和团队分析网站性能瓶颈并提供优化建议。
- SEO 优化:通过 SEO 分析工具提升网站在搜索引擎中的排名。
- 可访问性改进:确保网站符合可访问性标准,提升用户体验。
- 开发效率提升:集成到 AI 助手中,自动化性能分析和报告生成。
工具列表
- PageSpeed Insights API:提供详细的性能指标和优化建议。
- 自定义配置工具:支持按需配置分析策略(移动或桌面)、类别(性能、可访问性、最佳实践、SEO)和语言。
- 错误处理工具:处理无效 URL、网络超时、API 速率限制和服务器端错误。
常见问题解答
- 连接超时:检查网络连接是否稳定。
- API 速率限制:使用 API 密钥以提高限制。
- 内存问题:调整 Node.js 内存限制。
使用教程
使用依赖
- Node.js:确保已安装 Node.js。
- 稳定互联网连接:确保可以访问 Google PageSpeed Insights API。
安装教程
通过 Smithery 安装
bash
npx -y @smithery/cli install mcp-pagespeed-server --client claude
手动安装
bash
npm install pagespeed-mcp-server
配置
在 AI 助手的配置文件中添加以下内容:
json
{
"pagespeed": {
"command": "node",
"args": ["path/to/mcp-pagespeed-server/dist/index.js"]
}
}
调试方式
- 运行测试:
bash
npm run test - 查看日志:检查服务器日志以识别潜在问题。
- 验证 API 访问:确保可以正常访问 PageSpeed Insights API。