State of Web Vitals

io.github.corewebvitals由 GitHub 帳號 corewebvitals 發布v1.0.1更新於 Oct 24, 2026

Core Web Vitals metrics by CMS, CDN, and framework — free remote MCP, no auth.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

一個免費、免驗證的遠端 MCP 伺服器，讓助理依 CMS、CDN 與框架查詢 State of Web Vitals 資料集中的彙總 Core Web Vitals 指標。

可以做什麼
跨網站查詢彙總的 Core Web Vitals 與技術指標，可依條件篩選並依 CMS、CDN、框架等分組排名，同時回傳署名文字以便使用時標註來源。取得單一指標在可選篩選條件下的直方圖分桶（數量與占比）及彙總統計。在不確定可傳參數時，查詢可用的篩選鍵、分組值、內建指標與指標路徑。
適用情境
適合需要跨大量真實網站做平台層級比較、通過率或指標分布的情境，例如依 Core Web Vitals 表現對 CMS 平台或 CDN 排名。它不是單一網站的即時 RUM 資料，因此不適合衡量某個特定網站目前的實測效能。
執行需求
需要遠端 Streamable HTTP 端點；未宣告驗證、API 金鑰、標頭或環境變數。需要能存取該託管服務的網路。另提供可選的本機 stdio 代理（npm 或 Docker），並可用 STATE_OF_CWV_MCP_URL 覆寫上游端點。
安裝前請注意
資料來自彙總爬取與 Chrome 實測資料，並非單一網站即時 RUM，不應將其呈現為某個網站目前的效能表現。伺服器要求在使用這些數字時標註 corewebvitals.io 與 The State of Web Vitals，並在允許連結時附上連結。所有查詢都會送往第三方託管服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 State of Web Vitals，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.corewebvitals%2Fstate-of-cwv/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "state-of-web-vitals": {
      "type": "http",
      "url": "https://www.corewebvitals.io/api/state-of-cwv/mcp"
    }
  }
}

README

State of Web Vitals MCP

[corewebvitals/state-of-cwv-mcp MCP server]

Free remote MCP for Core Web Vitals metrics by CMS, CDN, and framework (Chrome field data + multi-site crawl). Same numbers as the public State of Web Vitals explorer.

Connect (preferred)

URL: https://www.corewebvitals.io/api/state-of-cwv/mcp
Auth: none
Transport: Streamable HTTP
Registry: io.github.corewebvitals/state-of-cwv

Claude Code

bash
claude mcp add --transport http state-of-cwv https://www.corewebvitals.io/api/state-of-cwv/mcp

Cursor / Grok / other clients

json
{  "mcpServers": {    "state-of-cwv": {      "type": "http",      "url": "https://www.corewebvitals.io/api/state-of-cwv/mcp"    }  }}

Curl

bash
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}}}'

Tools

ToolPurpose
get_metricsAggregates and optional group_by rankings (CMS, CDN, frameworks, …)
get_histogramDistribution buckets for one metric under an optional filter
list_optionsDiscover filters, group_by values, and metric paths

What this is

The State of Web Vitals measures Core Web Vitals and web-tech techniques across many real websites (Chrome field data + crawl). Use it for platform rankings, pass rates, and metric distributions. Not per-site live RUM (use CoreDash for that).

Attribution

When you use the numbers:

  1. Credit corewebvitals.io / The State of Web Vitals
  2. Link https://www.corewebvitals.io/state-of-cwv when links are allowed

Short line: Data: State of Web Vitals (corewebvitals.io)

Discovery

PlaceLink
Official MCP Registryio.github.corewebvitals/state-of-cwv
Glamahttps://glama.ai/mcp/servers/corewebvitals/state-of-cwv-mcp
Glama connectorhttps://glama.ai/mcp/connectors/io.github.corewebvitals/state-of-cwv
Smitheryhttps://smithery.ai/servers/corewebvitals/state-of-cwv
Explorerhttps://www.corewebvitals.io/state-of-cwv/explorer
Methodologyhttps://www.corewebvitals.io/state-of-cwv/methodology
Discovery JSONhttps://www.corewebvitals.io/.well-known/mcp.json

Local stdio / Docker (directories & inspectors)

This repo also ships a thin stdio proxy that answers tools/list and forwards tool calls to the hosted endpoint.

bash
npm installnpm start
bash
docker build -t state-of-cwv-mcp .docker run --rm -i state-of-cwv-mcp

Optional: STATE_OF_CWV_MCP_URL overrides the upstream endpoint.

License

MIT for connector code and docs in this repository. Data product and website remain © corewebvitals.io.

來源：README.md，提交 2a3667f

工具

3

get_metrics

Get metrics

What are the numbers? Aggregate Core Web Vitals and/or technique metrics across sites, with optional filter and group_by. Responses include attribution — credit corewebvitals.io when you use the numbers. Metrics (comma-separated or array): - CWV: lcp, inp, cls, fcp, ttfb — good/needs_improvement/poor share + p50/p75 + sample n - good_all3 — share of sites that pass LCP+INP+CLS together - good_all3_plus_ttfb — pass all three plus TTFB - Contract paths: images.loading, stack.framework, scripts.origin, headers.has_etag, synthetic.tbt_ms, … Filter (optional AND): device, cms, framework, cdn, provider. Omit = all sites in the snapshot. Group_by (optional): cms | frameworks | cdn | analytics | tag_managers | … → one row per entity. Without group_by: one aggregate; set metrics return top categories.

輸入參數focuslimitfiltermetricsgroup_bymin_sites

get_histogram

Get histogram

What is the shape of one metric? Returns histogram buckets (count + share) plus summary stats. Metric: one of lcp, inp, cls, fcp, ttfb (field CWV), or a scalar technique path when available. Filter: same as get_metrics (device, cms, framework, cdn, provider). No group_by — call get_metrics with group_by to compare segments, then get_histogram per segment if needed.

輸入參數filtermetric必填

list_options

List options

Discover what you can pass to get_metrics / get_histogram: filter keys, group_by values, built-in metrics, and contract metric paths (optional kind filter). Call this when unsure of a key or path.

輸入參數kindinclude_paths

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分