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": ""
        }
    }
}

详细功能

绩效指标分析

• 首款内容丰富的涂料（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. 连接超时

- 检查互联网连接

1. API速率限制

- 使用API键获得更高的限制

1. 内存问题

- 调整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许可证-有关详细信息，请参阅许可证文件