CoreDash. Real User Monitoring for Core Web Vitals

CoreDash MCP 服务

针对 Core Web Vitals 的真实用户监控。通过模型上下文协议查询真实访客的 LCP、INP 和 CLS 数据。

MCP 服务托管于 https://app.coredash.app/api/mcp。此仓库包含公开的连接器文档和注册清单。你无需安装或运行服务，只需将 MCP 客户端直接连接到托管端点即可。

CoreDash 是什么

CoreDash 是一个围绕 Core Web Vitals 构建的真实用户监控平台。它会收集真实访客的 LCP、INP 和 CLS 数据，并支持按页面模板、国家/地区、设备、浏览器、操作系统以及其他 20 多个维度进行细分。数据存储在欧盟。该产品无需同意横幅。付费套餐起价为每月 $19。更多信息请访问 coredash.app。

通过 MCP 提供的工具

工具	用途
get_metrics	当前性能分数（p75）。可按任意维度筛选和分组。用于回答“当前情况如何”之类的问题。
get_timeseries	随时间变化的指标，并附带 improving、stable 或 regressing 摘要。用于分析回归和趋势。
get_histogram	单项指标在约 40 个区间中的分布形态。用于查看流量分布是双峰、长尾，还是普遍较慢。

这三种工具都会返回评级区间（good、improve、poor），对应 Core Web Vitals 阈值。筛选维度包括设备（d）、国家/地区（cc）、页面路径（ff）、URL（u）、浏览器、操作系统，以及 LCP / INP / CLS 归因元素选择器。

身份验证

此服务支持两种方式：

1. OAuth（推荐）。 将 MCP 客户端指向服务 URL，并在出现提示时通过浏览器登录，无需 API 密钥。服务遵循 WWW-Authenticate 发现流程，并公开 /.well-known/oauth-authorization-server 和 /.well-known/oauth-protected-resource。
2. API 密钥。 适用于 CI 或无头环境。在 coredash.app/settings/api 生成密钥，并将其作为 Authorization: Bearer cdk_YOUR_API_KEY 传入。

匿名调用可成功执行 initialize（以便客户端检查服务能力），但任何工具调用都会失败。

连接

Claude Code

添加服务，然后在浏览器中进行身份验证：

claude mcp add --transport http coredash https://app.coredash.app/api/mcp

在 Claude Code 中运行 /mcp，选择 coredash，并完成 OAuth 登录。

如需改用 API 密钥（例如在 CI 中），请将其作为标头传入：

claude mcp add --transport http coredash https://app.coredash.app/api/mcp \
  --header "Authorization: Bearer cdk_YOUR_API_KEY"

Cursor

将配置添加到 ~/.cursor/mcp.json，然后在 Cursor 的 MCP 设置中点击服务旁的 Login，完成 OAuth 登录：

{
  "mcpServers": {
    "coredash": {
      "url": "https://app.coredash.app/api/mcp"
    }
  }
}

如需改用 API 密钥，请添加 "headers" 块，并设置 "Authorization": "Bearer cdk_YOUR_API_KEY"。

VS Code

将配置添加到工作区中的 .vscode/mcp.json（或通过 MCP: Open User Configuration 命令添加到用户配置）。VS Code 会在首次使用时提示你登录：

{
  "servers": {
    "coredash": {
      "type": "http",
      "url": "https://app.coredash.app/api/mcp"
    }
  }
}

如需改用 API 密钥，请添加 "headers" 块，并设置 "Authorization": "Bearer cdk_YOUR_API_KEY"。

Windsurf

在 Windsurf MCP 设置中使用与 Cursor 相同的 JSON 格式。

其他 MCP 客户端

使用 streamable-http 传输方式，将客户端指向 https://app.coredash.app/api/mcp。支持 OAuth 的客户端会通过 WWW-Authenticate 标头发现登录流程；否则，请传入 Authorization: Bearer cdk_YOUR_API_KEY 标头。

查询示例

Why is LCP slow on mobile in Germany this week?
Has INP regressed on the product detail template in the last 24 hours?
Show me the LCP distribution on /checkout/* in the US.

注册列表

此服务以 io.github.corewebvitals/coredash 的名称发布在 Official MCP Registry 上。之后会同步至 PulseMCP、Smithery、Glama 和 Windsurf。

注册清单位于 server.json。要发布新版本，请编辑该文件并运行 mcp-publisher publish。

相关项目

• cwv-superpowers。适用于 Claude Code、Cursor 和 Gemini 的技能包，可驱动此 MCP 服务诊断并修复 Core Web Vitals 问题。
• Core Web Vitals Visualizer。Chrome 扩展程序，可在任意页面上显示 CWV 指标叠加层。

许可证

MIT。请参阅 LICENSE。