PageSpeed MCP Server

PageSpeed MCP 服务

一种可通过 PageSpeed Insights 功能扩展 AI 助手能力的模型上下文协议（MCP）服务。此服务充当 AI 模型与 Google 的 PageSpeed Insights API 之间的桥梁，可对网站进行详细的性能分析。

概述

PageSpeed MCP 服务旨在增强 AI 助手的能力，使其能够全面分析 Web 性能。集成后，AI 模型可以请求并解读任何给定 URL 的详细性能指标、Core Web Vitals 以及其他关键 Web 性能数据。

安装

通过 Smithery 安装

如需通过 Smithery 自动为 Claude Desktop 安装 PageSpeed Server：

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

手动安装

npm install pagespeed-mcp-server

配置

将 PageSpeed MCP 添加到 AI 助手（此处为 Claude）的配置文件中：

{
    "pagespeed": {
        "command": "node",
        "args": ["path/to/mcp-pagespeed-server/dist/index.js"],
        "env": {
           "GOOGLE_API_KEY": "<YOUR-API-KEY>"
        }
    }
}

详细功能

性能指标分析

• 首次内容绘制（FCP）
• 最大内容绘制（LCP）
• 可交互时间（TTI）
• 总阻塞时间（TBT）
• 累积布局偏移（CLS）
• 速度指数
• 首字节时间（TTFB）

最佳实践评估

• HTTPS 使用情况
• JavaScript 错误监控
• 浏览器控制台警告
• 已弃用 API 的使用情况
• 图片宽高比分析
• 链接安全检查

SEO 分析

• 元描述验证
• Robots.txt 验证
• 结构化数据验证
• 可抓取链接验证
• 元标签评估
• 移动设备友好性

无障碍审计

• ARIA 属性验证
• 颜色对比度检查
• 标题层级分析
• 替代文本验证
• 焦点管理评估
• 键盘导航测试

资源优化

• 图片优化建议
• JavaScript 打包分析
• CSS 优化建议
• 缓存策略验证
• 资源压缩检查
• 渲染阻塞资源识别

API 响应结构

MCP 服务会提供详细的 JSON 响应，包括：

{
    "lighthouseResult": {
        "categories": {
            "performance": { /* Performance metrics */ },
            "accessibility": { /* Accessibility results */ },
            "best-practices": { /* Best practices audit */ },
            "seo": { /* SEO findings */ }
        },
        "audits": {
            // Detailed audit results for each category
        },
        "timing": {
            // Performance timing data
        },
        "stackPacks": {
            // Technology-specific advice
        }
    }
}

高级用法

自定义配置

你可以通过提供其他参数来自定义 PageSpeed 分析：

{
    "strategy": "mobile", // or "desktop"
    "category": ["performance", "accessibility", "best-practices", "seo"],
    "locale": "en",
    "threshold": {
        "performance": 90,
        "accessibility": 100,
        "best-practices": 90,
        "seo": 90
    }
}

错误处理

MCP 服务包含完善的错误处理机制，适用于：

• 无效 URL
• 网络超时
• API 速率限制
• 无效参数
• 服务端错误

要求

网络要求

• 稳定的互联网连接
• 可访问 Google 的 PageSpeed Insights API

平台支持

• Windows（x64、x86）
• Linux（x64）
• macOS（x64、arm64）

集成示例

基本集成

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'
});

故障排除

常见问题

1. 连接超时

   • 检查互联网连接

2. API 速率限制

   • 使用 API 密钥以提高限额

3. 内存问题

   • 调整 Node.js 内存限制

开发

从源代码构建

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

运行测试

npm run test

贡献

1. Fork 此代码仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

支持

获取帮助

• GitHub Issues：报告 Bug 和功能请求

许可证

MIT License - 详情请参阅 LICENSE 文件