项目简介

PageSpeed Insights MCP服务器是一个实现了Model Context Protocol (MCP) 的后端服务，旨在为大型语言模型（LLM）提供网页性能分析能力。通过集成 Google PageSpeed Insights API，该服务器允许LLM客户端调用工具分析指定URL的网页性能，并返回详细的性能指标、加载体验数据以及改进建议，帮助用户优化网页性能。

主要功能点

网页性能分析: 使用 Google PageSpeed Insights API 实时分析指定URL的网页性能。
详细性能指标: 返回网页的整体性能得分 (0-100)，以及详细的加载体验指标，如首次内容绘制 (FCP) 和首次输入延迟 (FID)。
改进建议: 提供网页性能改进建议，包括改进项的标题、描述、潜在影响和当前值。
结构化报告: 以JSON格式返回结构化的性能分析报告，方便LLM客户端解析和利用。
标准化接口: 遵循 MCP 协议，通过标准的JSON-RPC接口与客户端通信，易于集成到各种支持MCP协议的LLM应用中。

安装步骤

克隆仓库:

git clone https://github.com/enemyrr/mcp-server-pagespeed.git
cd mcp-server-pagespeed

安装依赖并构建项目:

npm install
npm run build

启动服务器: 在项目根目录下，运行以下命令启动服务器：
```
npx mcp-server-pagespeed
```
服务器将在标准输入/输出 (stdio) 上运行，等待 MCP 客户端的连接和请求。

服务器配置

要将 PageSpeed Insights MCP 服务器添加到 MCP 客户端（例如 Cursor IDE），您需要提供以下配置信息。请注意将 '/absolute/path/to/' 替换为实际的项目绝对路径。

{
  "servers": [
    {
      "name": "pagespeed",  // MCP 服务器的名称，客户端通过此名称引用
      "type": "command",   // 服务器类型为 command，表示通过命令行启动
      "command": "node",   // 启动服务器的命令，这里使用 node 解释器
      "args": [            // 传递给启动命令的参数
        "/absolute/path/to/mcp-server-pagespeed/build/index.js" // 服务器入口文件 build/index.js 的绝对路径
      ]
    }
  ]
}

配置参数说明:

'"name"': 服务器的唯一名称，例如 'pagespeed'。客户端在调用工具时会使用此名称。
'"type"': 服务器类型，设置为 '"command"' 表示通过执行命令行来启动服务器。
'"command"': 用于启动服务器的可执行命令，通常是 'node' 或服务器程序的可执行文件。
'"args"': 传递给 '"command"' 的参数数组。这里指定了服务器入口文件 'build/index.js' 的绝对路径。

基本使用方法

PageSpeed Insights MCP 服务器提供一个名为 'analyze_pagespeed' 的工具，用于分析网页性能。

客户端可以使用类似以下的指令来调用该工具：

use_mcp_tool({
  server_name: "pagespeed", // 指定要使用的 MCP 服务器名称，与配置中的 "name" 一致
  tool_name: "analyze_pagespeed", // 指定要调用的工具名称
  arguments: { // 工具的参数
    url: "https://example.com" // 要分析的网页 URL，替换为您要分析的实际网址
  }
});

LLM 客户端发送上述请求后，PageSpeed Insights MCP 服务器将调用 Google PageSpeed Insights API 分析提供的 URL，并将分析结果以 JSON 格式返回给客户端。返回结果包含网页的性能得分、加载体验指标以及性能改进建议。客户端可以解析返回的 JSON 数据，并根据需要进行后续处理，例如向用户展示性能报告或根据改进建议优化网页。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息