turbometrics-mcp

turbometrics MCP Server

将 Claude 和其他 AI 工具直接连接到你的 turbometrics.io 账户。

你可以做什么

向你的 AI 助手提问，例如：

扫描与性能

• “turbopress.de 的性能得分是多少？”
• “turbometrics.io 有哪些问题？”
• “我的得分这周有提升吗？”
• “比较 turbopress.de 和 turbometrics.io”
• “扫描 https://new-client-site.com 并向我展示结果”（任何 URL，甚至是未监控的 URL）
• “从 Helsinki 启动对 example.com 的扫描”

真实用户监控

• “显示 turbopress.de 的 Core Web Vitals”
• “过去 30 天，我的网站 LCP 趋势如何？”
• “turbopress.de 上哪些页面的 LCP 最差？”
• “比较本周和上周的 INP”

提醒与账户

• “显示所有未关闭的提醒”
• “按状态筛选并列出我最近的扫描”
• “显示提醒 #123 的详情”
• “将未读的得分提醒标记为已读”
• “我使用的是什么套餐？今天还剩多少 API 请求？”

要求

• 一个 turbometrics.io 账户（Starter 套餐或更高）

就是这样。你可以在浏览器中登录，无需复制令牌。

可用工具

工具	描述
list_domains	列出所有受监控的 URL，以及其计划和状态
get_latest_scan	最新扫描结果：得分、问题、TTFB、Core Web Vitals、报告链接
get_scan_history	得分历史记录——适用于受监控的新域名
get_findings	指定扫描的详细问题
list_alerts	列出未关闭、未读、已解决或所有提醒
get_rum_summary	真实用户监控摘要：Core Web Vitals 的 p75 值
get_rum_metric_history	RUM 指标（LCP、CLS、INP、FCP、TTFB）的每日趋势
get_rum_pages	按指标排名的最慢页面
compare_domains	并排比较两个域名，并提供各自的报告链接
trigger_scan	启动对任意 URL 的扫描——新的或受监控的 URL 均可；支持区域（de-fsn1、de-nbg1、fi-hel1）和强制扫描；受密码保护的网站会在 turbometrics.io 上扫描
list_scans	列出扫描——可按域名、状态和页面筛选，并提供报告链接
get_alert	获取指定提醒的详情
mark_alerts_read	将指定的提醒标记为已读（按 ID）
get_account_info	账户详情：套餐、API 限额、RUM 状态

每个工具都带有 MCP 注释（title、readOnlyHint、destructiveHint、 idempotentHint、openWorldHint）。其中 12 个工具只读取你的账户信息。 mark_alerts_read 会更改你指定提醒的已读状态，而 trigger_scan 是唯一会访问第三方网站的工具。

身份验证

使用 PKCE 的 OAuth 2.1。客户端会将你引导至 turbometrics.io，你批准一次后， 客户端便会保存令牌。访问令牌有效期为一小时，并会在后台续期；你可以随时在 个人资料 → API 与应用 中撤销任何已连接的应用。

不支持 OAuth 的客户端仍可使用同一页面上的个人 API 令牌进行身份验证，并通过 Authorization: Bearer YOUR_API_TOKEN 发送。

设置

Claude（推荐）

Claude 支持直接通过界面添加自定义连接器——无需 Node.js、无需 npx， 也无需编辑配置文件。

1. 在 Claude 中：设置 → 连接器 →“添加自定义连接器”
2. 输入：
   • 名称： turbometrics
   • URL： https://turbometrics.io/mcp
3. 点击 “添加”，然后点击 “连接”
4. 在打开的浏览器窗口中批准访问

请使用 .io，不要使用 .de——登录功能仅在 turbometrics.io 上提供，指向 另一个域名的连接器无法完成授权。

该连接器适用于你的整个 Claude 账户，包括 claude.ai、桌面应用和移动应用。

Claude Code

claude mcp add --transport http turbometrics https://turbometrics.io/mcp

首次使用时，浏览器会打开登录页面。

ChatGPT

开发者模式目前处于 Beta 阶段，需要 ChatGPT Plus 或 Pro。

1. 启用 Settings → Developer Mode
2. Apps & Connectors → create a new connector
3. 服务 URL：https://turbometrics.io/mcp
4. 选择 OAuth 作为身份验证方式，并在浏览器中批准

其他 MCP 客户端（Cursor、Windsurf 等）

设置	值
服务 URL	https://turbometrics.io/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1（自动发现），或 Authorization: Bearer YOUR_API_TOKEN

备用方案：通过 mcp-remote 进行本地设置

仅适用于没有连接器界面的客户端，或较旧版本的 Claude/ChatGPT 桌面应用。mcp-remote 会自行执行 OAuth 流程——无需在配置文件中填写令牌。需要 Node.js（brew install node，或从 nodejs.org 下载并运行安装程序）。

Mac 上的 ~/Library/Application Support/Claude/claude_desktop_config.json， Windows 上的 %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "turbometrics": {
      "command": "/opt/homebrew/bin/npx",
      "args": [
        "mcp-remote",
        "https://turbometrics.io/mcp"
      ]
    }
  }
}

根据你的系统调整 npx 路径（Mac 上运行 which npx，Windows 上在 CMD 中运行 where npx），然后重启客户端。

每个客户端的分步说明：turbometrics.io/docs/mcp

套餐

Starter 套餐及以上版本提供 API 访问权限。

套餐	每日 API 限额
Starter	1,000 次请求
Pro	5,000 次请求
Agency	不限量