](https://mseep.ai/app/phialsbasement-pagespeed-mcp-server)
PageSpeed MCP服务器
](https://smithery.ai/server/mcp-pagespeed-server)
一种模型上下文协议（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'
});故障排除
常见问题
- 连接超时
- 检查互联网连接
- 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贡献
- 分叉存储库
- 创建要素分支
- 提交您的更改
- 推到分支
- 创建拉取请求
支持
获取帮助
- GitHub问题：报告bug和功能请求
许可证
MIT许可证-有关详细信息，请参阅许可证文件