Ofgem

@pipeworx/ofgem

Ofgem 能源数据——英国能源监管机构发布的国内价格上限及其构成、天然气和电力批发价格、供应商市场份额、切换、债务和客户服务统计数据，以表格行而非图表形式返回。

属于 Pipeworx——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• ofgem_datasets(query?, page?) — 数据门户目录（约 190 个数据集）。 返回 dataset_id，这是此处其他工具都会用到的 ID。
• ofgem_price_cap(payment_method?, periods?) — 按周期划分的默认资费上限，细分为批发、网络、政策、运营、债务、EBIT 和 VAT 等组成部分，适用于直接扣款、预付费或标准信用付款。
• ofgem_dataset_rows(dataset_id, limit?, latest_first?) — 任意数据门户数据集背后的完整源表。

身份验证

无需密钥。

数据源

• https://www.ofgem.gov.uk/api/listing/2156 — 数据门户图表目录。
• https://app.everviz.com/inject/{dataset_id}/ — 单个数据集的源表。

值得了解的事项：

• 没有 CKAN、没有 Opendatasoft，也没有 JSON:API。 data.ofgem.gov.uk 完全无法解析（没有 A 记录，只有 MX 记录）。/jsonapi、 /api/v1/datasets 和 /api/search 均返回 404。数据门户页面不会在服务端渲染任何内容——直接抓取 /news-and-insight/data/data-portal/all-available-charts 时，结果中不含任何 数据集链接，因此抓取 HTML 会得到空列表，而不是错误。
• 目录位于 /api/listing/{paragraph_id}，这是门户前端自身调用的端点（在 themes/custom/numiko/dist/filter-listing-legacy-*.js 中找到）。 2156 是图表列表的段落 ID。该端点接受 fulltext= 和 page=（从 0 开始，每页 24 条）， 并在 meta.count 中报告匹配数量。
• 每条目录记录都在其行的摘要标记中的 data-js-chart-modal-data 属性里，以 HTML 转义后的 JSON 形式携带数据集内容，而不是作为 JSON 字段提供。必须先解除转义，再提取并解析。
• 表格不在 ofgem.gov.uk 上。 Ofgem 通过 everviz（Highsoft）发布每个数据集，而 everviz 嵌入脚本会在 options.data.csv 中携带源表 CSV。该 CSV 就是数据；此包会解析它。
• 这些 CSV 中的日期采用美式顺序（mm/dd/yyyy），尽管所有数值都是英国数据；价格上限明细表则使用周期标签（“Oct - Dec 2026”），而非日期。行标签按原样返回。
• CSV 标题会重复，部分标题为空，用作图表布局中的间隔。 名称为空的列会被删除；重复名称会添加 (2) 后缀，避免某一列悄然覆盖相邻列。
• ofgem_price_cap 会先从实时目录中解析数据集，只有在此失败时才回退到已知的 everviz ID，因此上游重命名会导致使用过期 ID，而不是无法返回结果。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "ofgem": {
      "url": "https://gateway.pipeworx.io/ofgem/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/ofgem/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于此表所列：目前，单个工具包端点除了列出该工具包自身的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威依据。

这是有意设计的，并非意外进行了多路复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过可跨整个目录进行路由的 ask_pipeworx——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过了路由带来的收益，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接获取每个工具包列出的所有工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出哪个工具包的工具；通过任一端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/ofgem_datasets \
  -H 'Content-Type: application/json' \
  -d '{"query":"price cap"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/ofgem_datasets。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关往返：

{
  "mcpServers": {
    "ofgem": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ofgem"]
    }
  }
}

或者直接运行它，确认服务能够启动：

npx -y @pipeworx/mcp-ofgem

它通过 stdin/stdout 使用 MCP，并针对仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。相同的源代码、相同的工具，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Ofgem data" })

网关会选择合适的工具并自动填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT