SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台mcp-google-crux

mcp-google-crux

Google CrUX MCP 是一个 MCP 服务器，用于把 Google Chrome UX Report（CrUX）的真实用户 Core Web Vitals 数据接入 AI 应用。它基于 Chrome 用户采集的现场数据（非合成测速），可以判断公开站点或页面是否通过 LCP、INP、CLS 评估，对比移动端与桌面端、源站与单个页面，并查看约 40 周的历史趋势。项目提供 6 个只读工具，涵盖 Core Web Vitals 评估、设备对比、源站与页面对比、40 周趋势以及最新或历史原始记录。数据可用性有明确边界：只有具备足够真实用户流量的公开源站和 URL 才有数据，返回 no_data 也是有效结果。CrUX 配额为每项目每分钟 150 次查询，设备对比会发起 4 次 API 调用，源站与页面对比发起 2 次。使用需 Node.js 20+ 和启用了 Chrome UX Report API 的 Google Cloud API 密钥。

访问官网

工具介绍

用途

Google CrUX MCP 将 Google CrUX（Chrome UX Report）的真实用户 Core Web Vitals 数据带入 AI 应用。它读取的是 Google 的 Chrome UX Report 数据集——来自 Chrome 用户的现场数据，而不是合成速度测试，也不能用来修改站点。它适合在对话中直接询问某个公开站点或页面是否通过核心网页指标评估，并做移动端、桌面端和历史趋势的对比分析。

主要能力

服务器提供 6 个只读工具：

  • Core Web Vitals 评估：判断某个公开源站或 URL 是否通过 LCP、INP、CLS 评估，并给出 p75 数值及其 good / needs-improvement / poor 评级和总体结果。
  • 设备对比：比较手机、桌面、平板和所有设备分组的结果及其流量占比。
  • 源站与页面对比：比较某个源站与某个具体 URL，判断页面比站点平均更快还是更慢。
  • 40 周趋势：查看 LCP、INP、CLS 在近期（如最近 25 周）的变化。
  • 原始最新记录与原始历史记录：暴露完整的 CrUX 直方图和分位数，适合技术审核。

数据说明：Core Web Vitals 的关键值是 p75，即 75% 的观测访问处于该值或以下。CrUX 报告采用滚动 28 天窗口、每日更新；历史数据按周更新，每周一更新。get_core_web_vitals 会替用户解读指标阈值；原始记录工具则暴露完整直方图和密度比例。

使用方式

前提条件：需要 Node.js 20+，以及一个启用了 Chrome UX Report API 的 Google Cloud API 密钥。

  1. 创建一个受限的 API 密钥。
  2. 把服务器添加到 AI 应用中。
  3. 提出只读问题，例如“https://example.com 在移动端是否通过 Core Web Vitals？”。

配置示例（各客户端的官方接入路径）：

  • 通用 MCP 客户端：在 Settings → MCP servers 中选择 Add server，选择 STDIO，输入命令 npx -y mcp-google-crux@latest 和环境变量 CRUX_API_KEY，然后 Save and Restart。
  • Claude Desktop：当前官方路径是 Settings → Extensions。对于自定义桌面扩展，打开 Advanced settings → Extension Developer → Install Extension…，选择一个 .mcpb 文件并按提示操作。该仓库目前发布的是 npm stdio 包，不包含 .mcpb 包。对于仍支持本地配置的 Claude Desktop 构建版本，可回退使用以下 JSON stdio 配置：
{"mcpServers":{"google-crux":{"command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}}

在这些构建版本中，macOS 保存到 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 保存到 %APPDATA%\Claude\claude_desktop_config.json。

  • Cursor：将 {"mcpServers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}} 添加到 macOS/Linux 的 ~/.cursor/mcp.json 或 Windows 的 %USERPROFILE%.cursor\mcp.json。
  • VS Code：运行 MCP: Open User Configuration 并添加配置，用 MCP: List Servers 检查。

适用场景

  • 询问某个公开源站或 URL 是否通过 Core Web Vitals。
  • 对比手机、桌面、平板和所有设备的指标结果。
  • 判断某个页面比站点平均更快还是更慢。
  • 查看 LCP、INP、CLS 在最近若干周的变化。
  • 调取原始 CrUX 直方图和分位数用于技术审核。

限制与注意事项

  • 数据可用性边界：只有具备足够真实用户流量的公开源站和 URL 才有数据；返回 no_data 不代表站点有问题，而是 Google 没有足够大的公开 Chrome 用户样本。平板和单个 URL 经常没有数据。
  • 配额：CrUX 允许每个项目每分钟 150 次查询。设备对比会发起 4 次 API 调用，源站与页面对比发起 2 次，做复合比较时需留意配额。
  • 只读公开数据集：服务器无法修改站点、Search Console、CrUX 记录或 Google 排名。
  • 配额感知重试：对 429、5xx 和网络错误采用退避重试。
  • 无后台监控：服务器仅在被调用时工作。若 AI 应用支持计划任务，可据此创建周期性性能报告。
  • 匿名遥测：发送安装和版本数据以及工具名称，绝不发送 API 密钥、查询的 URL、结果、参数或提示词；设置 ASKADS_TELEMETRY=0 可退出。
  • API 密钥存储于 MCP 客户端配置中，并随 API 请求 URL 发送，应视同密码对待。在 Google Cloud Console 中创建或选择项目即可，CrUX 不需要计费账号，但需启用 Chrome UX Report API 并将密钥限制为 Chrome UX Report API。

同类工具

查看分类