PageSpeed MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过 PageSpeed Insights 功能扩展 AI 助手的能力。此服务器充当 AI 模型和 Google PageSpeed Insights API 之间的桥梁，从而能够对网站进行详细的性能分析。

概述

PageSpeed MCP 服务器旨在通过允许 AI 助手执行全面的 Web 性能分析来增强其能力。集成后，AI 模型可以请求和解释任何给定 URL 的详细性能指标、核心 Web 指标和其他关键 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"]
    }
}

详细功能

性能指标分析

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

最佳实践评估

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

SEO 分析

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

可访问性审计

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

资源优化

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

API 响应结构

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

{
    "lighthouseResult": {
        "categories": {
            "performance": { /* 性能指标 */ },
            "accessibility": { /* 可访问性结果 */ },
            "best-practices": { /* 最佳实践审计 */ },
            "seo": { /* SEO 发现 */ }
        },
        "audits": {
            // 每个类别的详细审计结果
        },
        "timing": {
            // 性能计时数据
        },
        "stackPacks": {
            // 技术特定建议
        }
    }
}

高级用法

自定义配置

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

{
    "strategy": "mobile", // 或 "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：报告错误和功能请求

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE 文件