页面速度-MCP-服务器

Name: 页面速度-MCP-服务器
Author: PhialsBasement

作者：PhialsBasement8 星标更新：2025-09-14

安装使用来源：spider==github.com

项目介绍

PageSpeed MCP 服务器

这是一个扩展AI助手能力的模型上下文协议（MCP）服务器，通过集成PageSpeed Insights功能。此服务器作为AI模型与Google PageSpeed Insights API之间的桥梁，使网站性能分析更加详尽。

概述

PageSpeed MCP 服务器旨在增强AI助手的能力，使其能够执行全面的网页性能分析。当集成后，AI模型可以请求并解释给定URL的详细性能指标、核心网络生命值和其他关键的网页性能数据。

安装

通过 Smithery 安装

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

npx -y @smithery/cli install mcp-pagespeed-server --client claude

手动安装

npm install pagespeed-mcp-server

配置

在您的AI助手（此处为claude）的配置文件中添加PageSpeed MCP：

{
    "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 属性验证
色彩对比检查
标题层次分析
替代文本验证
焦点管理评估
键盘导航测试

资源优化

图像优化建议
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'
});

故障排除

常见问题

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

开发

从源码构建

git clone https://github.com/phialsbasement/mcp-pagespeed-server
cd mcp-pagespeed-server
npm install
npm run build

运行测试

npm run test

贡献

分叉仓库
创建功能分支
提交更改
推送到分支
创建拉取请求