小贴士:按下Ctrl+D 或 ⌘+D,一键收藏本站,方便下次快速访问!
MIT License
4
最近更新:2个月前

使用此 MCP 服务器拉取 pagespeed 数据。

PageSpeed MCP 服务器

smithery 徽章

一款通过 PageSpeed Insights 功能扩展 AI 助手能力的模型上下文协议(MCP)服务器。该服务器充当 AI 模型与谷歌 PageSpeed Insights API 之间的桥梁,实现对网站的详细性能分析。

概述

PageSpeed MCP 服务器旨在通过执行全面的网页性能分析来增强 AI 助手的能力。集成后,AI 模型可以请求并解释任意 URL 的详细性能指标、核心网页指标和其他关键网页性能数据。

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 PageSpeed 服务器:

bash 复制代码
npx -y @smithery/cli install mcp-pagespeed-server --client claude

手动安装

bash 复制代码
npm install pagespeed-mcp-server

配置

将 PageSpeed MCP 添加到您的 AI 助手(此处以 claude 为例)的配置文件中:

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

详细功能

性能指标分析

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

最佳实践评估

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

SEO 分析

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

可访问性审计

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

资源优化

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

API 响应结构

MCP 服务器提供详细的 JSON 响应,包括:

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

高级用法

自定义配置

您可以通过提供额外参数来自定义 PageSpeed 分析:

json 复制代码
{
    "strategy": "mobile", // 或 "desktop"
    "category": ["performance", "accessibility", "best-practices", "seo"],
    "locale": "en",
    "threshold": {
        "performance": 90,
        "accessibility": 100,
        "best-practices": 90,
        "seo": 90
    }
}

错误处理

MCP 服务器包含针对以下情况的健壮错误处理:

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

要求

网络要求

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

平台支持

  • Windows (x64, x86)
  • Linux (x64)
  • macOS (x64, arm64)

集成示例

基本集成

javascript 复制代码
const PageSpeedMCP = require('pagespeed-mcp-server');
const mcp = new PageSpeedMCP();

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

使用自定义选项

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

故障排除

常见问题

  1. 连接超时

    • 检查网络连接
  2. API 速率限制

    • 使用 API 密钥提高限制
  3. 内存问题

    • 调整 Node.js 内存限制

开发

从源代码构建

bash 复制代码
git clone https://github.com/phialsbasement/mcp-pagespeed-server
cd mcp-pagespeed-server
npm install
npm run build

运行测试

bash 复制代码
npm run test

贡献

  1. Fork 代码库
  2. 创建特性分支
  3. 提交更改
  4. 推送至分支
  5. 创建 Pull Request

支持

获取帮助

  • GitHub Issues:报告错误和功能请求

许可证

MIT 许可证 - 详见 LICENSE 文件