Pagespeed MCP Server

🚀 PageSpeed MCP 服务器

PageSpeed MCP 服务器是一个增强 AI 助手功能的模型上下文协议（MCP）服务器，集成了 PageSpeed Insights 功能。它作为 AI 模型与 Google 的 PageSpeed Insights API 之间的桥梁，可实现对网站性能的详细分析。

🚀 快速开始

PageSpeed MCP 服务器旨在提升 AI 助手的能力，使其能够执行全面的网络性能分析。当集成后，AI 模型可以请求并解析指定 URL 的详细性能指标、核心网页关键指标（Core Web Vitals）及其他重要网络性能数据。

📦 安装指南

使用 Smithery 安装

通过 Smithery 自动安装 Claude Desktop 的 PageSpeed 服务器：

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）
• Speed Index 指数
• 首字节时间（TTFB）

最佳实践评估

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

SEO 分析

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

可访问性审计

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

资源优化

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

API 响应结构

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

{
    "lighthouseResult": {
        "categories": {
            "performance": { /* 性能指标 */ },
            "accessibility": { /* 可访问性结果 */ },
            "best-practices": { /* 最佳实践评估 */ },
            "seo": { /* SEO 分析 */ }
        },
        "details": {
            "performanceMetrics": [/* 性能指标详情 */],
            "accessibilityIssues": [/* 可访问性问题 */],
            "optimizationSuggestions": [/* 优化建议 */]
        }
    }
}

高级用法

自定义配置

在配置文件中添加自定义设置：

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

错误处理

处理可能出现的错误：

try {
    const result = await pagespeed.analyze(url);
    console.log(result);
} catch (error) {
    console.error("分析失败:", error.message);
}

要求

• 平台支持: 支持 Windows、Linux 和 macOS 系统。
• Node.js 版本: 需要 Node.js 14 或更高版本。

获取帮助

如需支持，请访问 GitHub Issues 报告问题和功能请求。

📄 许可证

MIT License - 详见 LICENSE 文件