关于 State of Web Vitals
State of Web Vitals 是用于查询按 CMS、CDN 和框架聚合的 Core Web Vitals 数据的远程 MCP 服务。数据来自 Chrome 实测数据和多站点爬取,可用于查看排名、达标率和指标分布。
主要功能
- 01汇总 Core Web Vitals 指标
- 02按 CMS、CDN 或框架排名
- 03查看指标分布直方图
- 04发现筛选项和指标路径
适用场景
- 01比较不同 CMS 平台的指标
- 02查看按 CDN 划分的达标率
- 03探索某项网页指标的分布
MCP 相关
远程 MCP 服务通过 Streamable HTTP 向客户端提供 get_metrics、get_histogram 和 list_options,无需身份验证。项目还包含一个精简的本地 stdio 代理。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://www.corewebvitals.io/api/state-of-cwv/mcpclaude mcp add --transport http corewebvitals-state-of-cwv https://www.corewebvitals.io/api/state-of-cwv/mcp{"mcpServers":{"corewebvitals-state-of-cwv":{"type":"http","url":"https://www.corewebvitals.io/api/state-of-cwv/mcp"}}}在 Cursor 中打开{"servers":{"corewebvitals-state-of-cwv":{"type":"http","url":"https://www.corewebvitals.io/api/state-of-cwv/mcp"}}}在 VS Code 中打开{"mcpServers":{"corewebvitals-state-of-cwv":{"type":"http","url":"https://www.corewebvitals.io/api/state-of-cwv/mcp"}}}{"mcpServers":{"corewebvitals-state-of-cwv":{"serverUrl":"https://www.corewebvitals.io/api/state-of-cwv/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| focus | enum | 否 | 关联技术指标时使用的 CWV。默认值:lcp。lcp | inp | cls | fcp | ttfb |
| limit | integer | 否 | 分组或顶级类别的最大数量。默认值:25,最大值:100。 |
| filter | object | 否 | AND 筛选条件。不指定则包含数据集中的所有站点。键:device (all|phone|desktop)、cms、framework、cdn、provider(键)、provider_category(例如 analytics — 需与 provider 一起使用,单独使用无效;排名建议使用 group_by)。 |
| filter.cdn | string | 否 | 仅包含使用此 CDN 键(cloudflare、origin、…)的站点。 |
| filter.cms | string | 否 | 仅包含使用此 CMS 键(wordpress、shopify、wix、…)的站点。 |
| filter.device | enum | 否 | CrUX 设备维度。默认值:all。all | phone | desktop |
| filter.provider | string | 否 | 仅包含加载此第三方 provider 键(google_analytics_4、…)的站点。 |
| filter.framework | string | 否 | 仅包含使用此 JS 框架键(react、vue、jquery、…)的站点。 |
| metrics | any | 否 | 要返回的指标。默认值:lcp,inp,cls,ttfb,good_all3。字符串(逗号分隔)或字符串数组。 |
| group_by | string | 否 | 按此维度拆分结果:cms、frameworks、cdn 或 provider 类别(analytics、tag_managers、…)。省略则返回单个聚合结果。 |
| min_sites | integer | 否 | 设置 group_by 时,排除站点数较少的分组。默认值:50。 |
详细介绍
State of Web Vitals MCP
免费的远程 MCP,可按 CMS、CDN 和框架查询 Core Web Vitals 指标(Chrome 实测数据 + 多站点抓取)。数据与公开的 State of Web Vitals 探索器相同。
连接(首选)
URL: https://www.corewebvitals.io/api/state-of-cwv/mcp
身份验证: 无
传输方式: Streamable HTTP
注册表: io.github.corewebvitals/state-of-cwv
Claude Code
claude mcp add --transport http state-of-cwv https://www.corewebvitals.io/api/state-of-cwv/mcp
Cursor / Grok / 其他客户端
{
"mcpServers": {
"state-of-cwv": {
"type": "http",
"url": "https://www.corewebvitals.io/api/state-of-cwv/mcp"
}
}
}
Curl
curl -s -X POST https://www.corewebvitals.io/api/state-of-cwv/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_metrics","arguments":{"metrics":"lcp,good_all3","group_by":"cms","min_sites":100}}}'
工具
| 工具 | 用途 |
|---|---|
get_metrics | 聚合数据和可选的 group_by 排名(CMS、CDN、框架等) |
get_histogram | 某项指标在可选筛选条件下的分布区间 |
list_options | 查看筛选条件、group_by 值和指标路径 |
项目介绍
The State of Web Vitals 基于众多真实网站的数据(Chrome 实测数据 + 抓取)衡量 Core Web Vitals 和 Web 技术。可用于平台排名、通过率和指标分布查询。它不提供单站点实时 RUM 数据(此类数据请使用 CoreDash)。
署名
使用这些数据时:
- 标明来源为 corewebvitals.io / The State of Web Vitals
- 如果允许添加链接,请链接到 https://www.corewebvitals.io/state-of-cwv
简短署名:数据来源:State of Web Vitals (corewebvitals.io)
发现
| 平台 | 链接 |
|---|---|
| 官方 MCP 注册表 | io.github.corewebvitals/state-of-cwv |
| Glama | https://glama.ai/mcp/servers/corewebvitals/state-of-cwv-mcp |
| Glama 连接器 | https://glama.ai/mcp/connectors/io.github.corewebvitals/state-of-cwv |
| Smithery | https://smithery.ai/servers/corewebvitals/state-of-cwv |
| 探索器 | https://www.corewebvitals.io/state-of-cwv/explorer |
| 方法 | https://www.corewebvitals.io/state-of-cwv/methodology |
| 发现 JSON | https://www.corewebvitals.io/.well-known/mcp.json |
本地 stdio / Docker(目录与检查器)
此仓库还提供了一个轻量级 stdio 代理,可响应 tools/list 并将工具调用转发到托管端点。
npm install
npm start
docker build -t state-of-cwv-mcp .
docker run --rm -i state-of-cwv-mcp
可选:STATE_OF_CWV_MCP_URL 可覆盖上游端点。
许可证
本仓库中的连接器代码和文档采用 MIT 许可证。数据产品和网站仍归 corewebvitals.io 所有,版权所有。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。