GTmetrix MCP

官方

官方 GTmetrix MCP：从 AI 工具运行真实的网页性能测试、查看报告、跟踪历史记录并管理监控。可使用访客访问；完整功能需使用 OAuth 或 API 密钥。

访问 gtmetrix.com

你可以用 GTmetrix MCP 做什么？

  • 运行性能测试 — 让助手从指定位置、使用指定浏览器、设备和限速预设测试 URL，然后返回报告。
  • 分析报告 — 获取 GTmetrix 评分、Core Web Vitals 和 Lighthouse 主要问题，并获取 HAR 和 Lighthouse JSON 下载链接。
  • 跟踪历史记录和回归情况 — 列出页面及其最新评分，并获取某个页面的所有报告，以比较随时间变化的趋势。
  • 管理监控和提醒 — 开启或关闭监控，并针对评分、耗时、页面大小、请求数或 CLS 设置提醒条件。
  • 使用标签整理页面 — 一次为最多 500 个页面创建、重命名、添加或删除标签。
  • 查看账户和目录 — 查看剩余额度，并查询可用的位置、浏览器、设备和限速预设。

托管 MCP 服务器

npx add-mcp 'https://gtmetrix.com/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

GTmetrix MCP

官方 GTmetrix MCP 服务器可将你的 AI 工具连接到 GTmetrix，让它通过提示词运行真实的页面性能测试、读取报告、跟踪历史记录并管理监控。

无需 GTmetrix 账户即可试用。 以访客身份连接，即可立即开始测试。登录后可解锁更多测试和功能。

  • 服务器 URL： https://gtmetrix.com/mcp
  • 传输方式： Streamable HTTP（远程，无需安装）
  • 身份验证： 访客（无需登录）、OAuth，或通过 Authorization: Bearer 标头提供 API 密钥
  • 适用工具： Claude、ChatGPT、Codex、Cursor、GitHub Copilot CLI 以及任何兼容 MCP 的客户端

快速开始

选项 1：OAuth（推荐）

  1. 在你的 AI 工具中添加新的远程 MCP 服务器 / 自定义连接器。
  2. 将其命名为 GTmetrix，并将 URL 设置为 https://gtmetrix.com/mcp。
  3. 点击 Connect / Authenticate。

无需 API 密钥。你也可以从 GTmetrix 账户页面的 MCP Setup 部分复制 MCP URL。

以访客身份使用

开始使用无需 GTmetrix 账户。作为访客，你可以使用有限数量的访客额度运行测试、读取报告，以及查询位置、浏览器和设备。

访客额度用完后，或者你想使用与账户关联的功能（页面历史记录、监控、提醒、标签）时，请让 AI 帮你登录。它会调用 gtmetrix_reauthenticate，然后你会看到一个登录页面，可以登录或创建免费账户。

选项 2：API 密钥

在 GTmetrix 账户页面生成 API 密钥，然后将其添加到客户端配置中。

Claude Code

claude mcp add gtmetrix https://gtmetrix.com/mcp --transport http --header "Authorization: Bearer YOUR_API_KEY"

Codex（config.toml）

[mcp_servers.gtmetrix]
url = "https://gtmetrix.com/mcp"

[mcp_servers.gtmetrix.http_headers]
Authorization = "Bearer YOUR_API_KEY"

JSON 配置（Cursor 和其他支持远程 HTTP 服务器的客户端）

{
  "mcpServers": {
    "gtmetrix": {
      "url": "https://gtmetrix.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot CLI（仅支持 OAuth）

/mcp add GTmetrix

将 Server Type 设置为 HTTP，将 URL 设置为 https://gtmetrix.com/mcp，将 Tools 设置为 *，保存，然后在浏览器中完成身份验证。

分步指南：Claude · ChatGPT · Codex · Cursor · Copilot CLI

示例提示词

  • “从伦敦和悉尼通过 LTE 在 iPhone 上测试 example.com，并告诉我性能是否相当。”
  • “分析 example.com 的最新报告，并用通俗易懂的语言解释排名前 3 的问题。”
  • “检查我所有带有 'client' 标签的受监控页面。标出评级低于 B 或 LCP 超过 2s 的页面。”
  • “将本周结账页面的报告与上个月的报告进行比较。性能是否有所退步？”
  • “为我的主页设置每日监控，并在 LCP 超过 2.5 秒时提醒我。”
  • “修复网站上阻塞渲染的 JavaScript，然后重新运行 GTmetrix 并确认性能有所改善。”

工具

访客可以使用测试工具（gtmetrix_get_report_har 除外）以及账户和参考工具。其他工具需要 GTmetrix 账户。

测试

工具功能
gtmetrix_start_test对 URL 启动测试。支持位置、浏览器、模拟设备、连接限速、AdBlock、视频、Cookie、HTTP 身份验证、URL 允许/阻止列表、视口大小以及报告保留期限（1、6、12 或 24 个月）。
gtmetrix_get_test检查正在运行的测试。在服务器端进行长轮询（每次调用最长 30s），并在测试完成后返回报告 ID。
gtmetrix_get_report获取已完成的报告：GTmetrix 评级、Performance 和 Structure 分数、Core Web Vitals（LCP、TBT、CLS）、按影响程度排序的前 5 个 Lighthouse 问题、资源摘要，以及 HAR 和完整 Lighthouse JSON 的下载链接。
gtmetrix_get_report_har在行内返回 HAR 瀑布图，适用于无法直接下载 HAR URL 的客户端。默认限制大小。

历史记录和页面

工具功能
gtmetrix_list_pages列出你的页面（URL + 测试设置），并显示最新分数、Web Vitals、监控状态和标签。可按 URL、位置、浏览器、设备、限速、监控频率、标签等筛选。
gtmetrix_get_report_history按时间从新到旧获取某个页面的所有报告，用于趋势和回归分析。

监控和提醒

工具功能
gtmetrix_set_page_monitoring为页面开启（每小时、每天、每周、每月）或关闭监控。
gtmetrix_get_page_alert_conditions读取页面的提醒条件。
gtmetrix_set_page_alert_conditions设置分数、耗时（LCP、TTFB、TBT 等）、页面大小、请求数或 CLS 的提醒条件。
gtmetrix_get_page_alert_events列出页面触发的提醒，并附上相关报告的链接。

标签

工具功能
gtmetrix_list_page_tags列出你的标签及每个标签关联的页面数量。
gtmetrix_save_page_tag创建标签，或重命名/更改现有标签的颜色。
gtmetrix_update_page_tags一次为最多 500 个页面添加或移除标签。
gtmetrix_delete_page_tag永久删除标签。

账户和参考

工具功能
gtmetrix_get_account_status显示你的套餐、剩余 API 额度和下次补充日期（访客可查看剩余访客额度）。
gtmetrix_get_catalog查询可用的浏览器、位置、模拟设备、限速预设和 Lighthouse 审计项。
gtmetrix_get_guide阅读有关测试选项、报告分析、HAR 分析和测试错误的内置指南。
gtmetrix_reauthenticate从访客连接登录，或切换到其他 GTmetrix 账户。

资源

服务器还会将指南和目录作为 MCP 资源提供：

  • gtmetrix://docs/test-options-guide
  • gtmetrix://docs/report-analysis-guide
  • gtmetrix://docs/har-analysis-guide
  • gtmetrix://docs/general-test-error-guide
  • gtmetrix://docs/lighthouse-error-guide
  • gtmetrix://catalog/browsers
  • gtmetrix://catalog/locations
  • gtmetrix://catalog/simulated-devices
  • gtmetrix://catalog/throttle-connections
  • gtmetrix://catalog/lighthouse-audits

额度和限制

  • 任何人都可以使用 MCP。访客可获得有限额度；GTmetrix 账户可提供更多额度。
  • 测试和其他操作按与 GTmetrix API 相同的费率消耗 API 额度。每次测试的视频录制会额外消耗 0.9 个额度。
  • 额度取决于你的套餐。部分 PRO 套餐每天补充额度。让 AI 运行 gtmetrix_get_account_status 查看余额。
  • 并发测试数：Basic 为 2，PRO 为 8。
  • 部分功能（更多位置、每小时监控、提醒中的视频）取决于你的套餐。

查看 GTmetrix PRO 套餐

常见问题

这是一个聊天机器人吗？ 不是。这是一个连接层，可让你正在使用的 AI 工具访问 GTmetrix。

我需要 GTmetrix 账户吗？ 不需要。你可以以访客身份连接并立即运行测试。登录后可解锁更多测试和功能。

我需要 API 密钥吗？ 仅手动配置时需要。OAuth 连接无需 API 密钥。

为什么结果没有以图表形式显示？ 结果的呈现方式取决于你的 AI 工具。获取报告后，可以让它“将这些数据可视化”。

它能帮我修复问题吗？ GTmetrix 提供数据和诊断信息。如果你的 AI 工具也能编辑代码或 CMS 内容，就可以应用修复并重新运行测试以确认结果。

链接