药瓶地下室_页面速度-MCP-服务器

Name: 药瓶地下室_页面速度-MCP-服务器
Author: MCP-Mirror

作者：MCP-Mirror7 星标更新：2025-05-14

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

项目介绍

PageSpeed MCP 服务器

这是一个扩展AI助手功能的Model Context Protocol (MCP)服务器，通过集成PageSpeed Insights功能。该服务器作为AI模型与Google PageSpeed Insights API之间的桥梁，使网站性能分析更加详尽。

概述

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

安装

通过Smithery安装

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

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

详细功能

性能指标分析

首次内容绘制（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

贡献

分叉仓库
创建功能分支
提交更改
推送到分支
创建Pull Request