使用说明
项目简介
PageSpeed MCP Server 扩展了 AI 助手的能力,使其可以进行网站性能分析。它充当 AI 模型和 Google PageSpeed Insights API 之间的桥梁,允许 AI 获取并解释详细的网站性能指标、最佳实践、SEO 和可访问性等方面的数据。通过集成此 MCP 服务器,AI 助手可以为用户提供更全面的网站性能评估和优化建议。
主要功能点
- 网站性能指标分析 (Performance Metrics Analysis): 提供 First Contentful Paint (FCP)、Largest Contentful Paint (LCP)、Time to Interactive (TTI) 等关键性能指标。
- 最佳实践评估 (Best Practices Assessment): 检查 HTTPS 使用情况、JavaScript 错误监控、弃用 API 使用等最佳实践。
- SEO 分析 (SEO Analysis): 验证 Meta 描述、robots.txt、结构化数据,并评估移动设备友好性。
- 可访问性审计 (Accessibility Audits): 检查 ARIA 属性、颜色对比度、标题层次结构、Alt 文本等可访问性问题。
- 资源优化建议 (Resource Optimization): 提供图片优化、JavaScript 打包、CSS 优化、缓存策略等建议。
安装步骤
-
确保已安装 Node.js 和 npm。
-
打开终端,运行以下命令安装 'pagespeed-mcp-server':
npm install pagespeed-mcp-server
服务器配置(用于 MCP 客户端)
要将 PageSpeed MCP Server 集成到 MCP 客户端(例如 Claude),您需要在客户端的配置文件中添加以下服务器配置信息。请根据您的实际安装路径调整 'args' 中的路径。
{ "pagespeed": { // server name,客户端配置中用于标识此服务器,可以自定义 "command": "node", // 启动服务器的命令,通常为 node "args": ["path/to/mcp-pagespeed-server/dist/index.js"] // 启动参数,指向服务器入口文件,需要替换为实际安装路径 } }
基本使用方法
配置完成后,AI 助手可以通过调用 'run_pagespeed_test' 工具来使用 PageSpeed MCP Server。
例如,在与 AI 助手的对话中,您可以指示它进行页面速度测试,并提供要分析的 URL。AI 助手会将请求发送到 PageSpeed MCP Server,服务器会调用 Google PageSpeed Insights API 并返回分析结果。
工具名称: 'run_pagespeed_test'
工具描述: Run a PageSpeed Insights test on a URL. Tests page performance, accessibility, SEO, and best practices.
输入参数 (JSON Schema):
{ "type": "object", "properties": { "url": { "type": "string", "format": "url" }, "strategy": { "type": "string", "enum": [ "mobile", "desktop" ], "default": "mobile" }, "category": { "type": "array", "items": { "type": "string", "enum": [ "accessibility", "best-practices", "performance", "pwa", "seo" ] }, "default": [ "performance" ] }, "locale": { "type": "string", "default": "en" }, "apiKey": { "type": "string", "optional": true } }, "required": [ "url" ] }
示例对话 (AI 助手)
用户: 请分析一下 example.com 的网站性能。
AI 助手: 好的,我将使用 PageSpeed 工具分析 example.com 的网站性能。
(AI 助手调用 'run_pagespeed_test' 工具,参数为 '{"url": "https://example.com"}',PageSpeed MCP Server 返回 JSON 结果)
AI 助手: 根据 PageSpeed Insights 的分析结果,example.com 的性能报告如下... (展示分析结果)
信息
分类
网页与API