AI导哈

网站性能分析服务器

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

  • by PhialsBasement
  • JavaScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 PhialsBasement/Pagespeed-MCP-Server

使用说明

PageSpeed MCP服务器

一种模型上下文协议（MCP）服务器，通过PageSpeed Insights功能扩展了AI助手的功能。该服务器是人工智能模型和谷歌PageSpeed Insights API之间的桥梁，能够对网站进行详细的性能分析。

概述

PageSpeed MCP服务器旨在通过允许AI助手执行全面的web性能分析来增强其功能。集成后，人工智能模型可以请求和解释任何给定URL的详细性能指标、核心网络生命体征和其他关键网络性能数据。

安装

通过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"],
        "env": {
           "GOOGLE_API_KEY": "<YOUR-API-KEY>"
        }
    }
}

详细功能

绩效指标分析

  • 首款内容丰富的涂料（FCP）
  • 最大容量涂料（LCP）
  • 互动时间（TTI）
  • 总阻塞时间（TBT）
  • 累积布局偏移（CLS）
  • 速度指数
  • 第一字节时间（TTFB）

最佳实践评估

  • HTTPS使用情况
  • JavaScript错误监控
  • 浏览器控制台警告
  • 不推荐使用API
  • 图像纵横比分析
  • 链接安全检查

SEO分析

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

可访问性审计

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

资源优化

  • 图像优化建议
  • 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. 分叉存储库
  2. 创建要素分支
  3. 提交您的更改
  4. 推到分支
  5. 创建拉取请求

支持

获取帮助

  • GitHub问题：报告bug和功能请求

许可证

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

相关 MCP