PageSpeed MCP 服务器

一个扩展了 AI 助手功能的 Model Context Protocol (MCP) 服务器，通过 PageSpeed Insights 功能实现。该服务器充当 AI 模型与 Google 的 PageSpeed Insights API 之间的桥梁，能够对网站进行详细的性能分析。

概述

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

安装

通过 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)
速度指数
首字节时间 (TTFB)

最佳实践评估

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

SEO 分析

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

可访问性审核

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

故障排除

常见问题

连接超时
- 检查互联网连接
API 速率限制
- 使用 API 密钥以获得更高的限制
内存问题
- 调整 Node.js 内存限制

开发

从源代码构建

git clone https://github.com/PhialsBasement/Pagespeed-MCP-Server
cd mcp-pagespeed-server
npm install
npm run build

运行测试

npm run test

贡献

Fork 仓库
创建一个功能分支
提交你的更改
推送到该分支
创建一个 Pull Request