PageSpeed MCP Server

基本能力

产品定位

PageSpeed MCP Server 是一个桥梁服务，连接 AI 模型和 Google 的 PageSpeed Insights API，提供全面的网站性能分析功能。

核心功能

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

适用场景

• AI 助手需要提供网站性能分析时。
• 开发人员需要快速获取网站性能指标和优化建议。
• SEO 专家需要评估网站的搜索引擎优化状态。

工具列表

• PageSpeed Insights API: 提供网站性能分析的核心功能。
• Node.js: 运行 MCP 服务器的基础环境。
• Smithery: 提供自动安装和配置服务。

常见问题解答

• 连接超时: 检查网络连接。
• API 速率限制: 使用 API 密钥提高限制。
• 内存问题: 调整 Node.js 内存限制。

使用教程

使用依赖

• Node.js: 确保已安装 Node.js 环境。

安装教程

通过 Smithery 安装

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

手动安装

npm install pagespeed-mcp-server

配置

将 PageSpeed MCP 添加到 AI 助手的配置文件中:

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

调试方式

基本集成

const PageSpeedMCP = require('pagespeed-mcp-server');
const mcp = new PageSpeedMCP();

await mcp.analyze('https://example.com');

自定义选项

const results = await mcp.analyze('https://example.com', {
    strategy: 'mobile',
    categories: ['performance', 'accessibility'],
    locale: 'en-US'
});

从源代码构建

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

运行测试

npm run test

许可证

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