使用说明

项目简介

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 优化、缓存策略等建议。

安装步骤

  1. 确保已安装 Node.js 和 npm。

  2. 打开终端,运行以下命令安装 '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