Georgia Energy

@pipeworx/georgia-energy

格鲁吉亚（国家）的全国电力系统：来自输电系统运营商的实时电网遥测数据，以及监管机构按电站提供的月度发电量和价格序列。

属于 Pipeworx——一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是一项独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

工具

• gse_grid_now(...) — 截至最新发布的 3 分钟时段的电网数据： 水电／火电／风电／太阳能发电量、总发电量、与阿塞拜疆、亚美尼亚、俄罗斯（单独列出 Salkhino、Java 和 Nakaduli 线路）及土耳其的跨境输电，以及总用电量，单位为 MW。
• gse_grid_at(...) — 指定过去某个时段的相同数据块，范围在滚动约 30 天的留存窗口内。
• gse_frequency(...) — 系统频率，单位为 Hz（标称值 50），每分钟更新一次。频率与 50 的偏差可直接反映发电与需求之间的平衡情况。
• gse_demand_forecast(...) — 次日预测，逐小时提供用电量、供电量、火电、水电（调节性和季节性）、风电、进口和出口数据。
• gse_publications(...) — 运营商的报告和通知，包括发电充足性评估、年度报告和 SESA。
• gse_tenders(...) — 运营商的采购招标信息；如有发布，还包括中标方和投标价格。
• gnerc_station_generation(...) — 各电站的月度发电量（Enguri、Vardnili 梯级、Khrami 1/2、Zhinvali、Gardabani thermal 1/2、Kartli 风电场、指定太阳能电站），以及全国供电量、用电量、进口、出口和指定大型直供用户数据，时间范围为 2015-2026 年。
• gnerc_prices(...) — 月度平衡电价、保证容量费，以及 ESCO 向非管制电站支付的价格，时间范围为 2015-2026 年。

身份验证

无需密钥。两个发布方均不要求令牌、Cookie 或注册。

数据来源

• https://admin.gse.com.ge/storage/uploads/fact/ — 格鲁吉亚国家电力系统股份公司（GSE）的实时系统导出数据。GSE_EXPORT_NEW_PERIOD_03M_*.XML 每 3 分钟更新一次，GSE_EXPORT_PERIOD_01M_*.XML（频率）每分钟更新一次。
• https://admin.gse.com.ge/api/file-exists?path=... — GSE 用于检查上述文件是否存在的接口。已验证其能正确区分存在和不存在两种情况。
• https://admin.gse.com.ge/api/{en,ka}/{publications,news,announcements,projects,tenders,categories} — 运营商的 Laravel 内容 API。meta.total 是真实总数。
• https://admin.gse.com.ge/storage/uploads/consumption_files/excel/FORECAST-YYYYMMDD.xls — 次日用电量预测。
• https://data.gnerc.org/excel/ — 格鲁吉亚国家能源与供水监管委员会（GNERC）的开放数据工作簿。

否则很容易在踩坑后才发现的事项

GSE 文件名使用第比利斯当地时间（UTC+4），而非 UTC，分钟向下取整到 3 的倍数，并且发布时间有所延迟。查询当前分钟会返回 404，而不是错误——因此，“现在”必须指“最新的已存在时段”，这就是为什么每次读取都会向前回溯，并先用 file-exists 确认时段确实存在。延迟并非原始示例所示的约 2 分钟：观测到 1 分钟频率的数据流落后了 9–10 个时段。因此，回溯探测会以并发批次进行——向第比利斯连续发起 10 次往返请求约需 4 秒，其中大部分时间都在等待。

每个遥测值都带有 QUALITY 属性，其中大多数并非测量值。 ACT 表示实际遥测；SUB 表示由运营方替代；NRE 表示未收到。一次具有代表性的实时导出包含 3 个 ACT、7 个 SUB 和 3 个 NRE——全国用电量为 NRE，水电总量为 SUB。因此，每一行都会带上该标记，并在响应顶部汇总。若将其丢弃，就会把填充值当作测量值返回，这比什么都不返回更糟。

解析实时 XML 前，需要去掉其前导内容：它声明编码为 ISO-8859-1（内容实际为 ASCII），包含一个 <?xml-stylesheet?> PI，并带有一个严格解析器会尝试解析的 <!DOCTYPE ... SYSTEM 'GSE_V1.DTD'>。BLOCK_AREA/@Name 会填充空格以达到固定宽度，因此匹配前需要先去除空格。

日前预测文件确实是 Excel 97 文件（魔数为 D0 CF 11 E0），而不是套着 .xls 扩展名的 HTML 表格，因此在读取 BIFF8 记录流前，需要先遍历 OLE2 复合文件容器。src/xlsx.ts 无需依赖即可完成这两项工作，并支持 Workers 运行时。

data.gnerc.org 发送的叶证书没有中间证书。 Node 自带的 CA 证书库无法构建其证书链，会报错 UNABLE_TO_VERIFY_LEAF_SIGNATURE，因此在 Worker 外运行本地脚本测试此工具包时，会看起来像是网站宕机了。Cloudflare 的出口网络可以正常解析它（已于 2026-09-10 通过我们自己的网关进行实时验证）。不要通过更换主机名来“修复”此问题——其他选项提供的证书链也只有这张证书，而且 gnerc.org/excel/ 会返回 500。

GNERC 平衡表工作簿约为 450 KB，因此每个 isolate 只会获取并解析一次，缓存 6 小时，而不是每次调用都重新下载。

平衡表中，C 到 N 列分别对应 1 月到 12 月，O 列为全年合计——但空月份会以没有值的自闭合单元格形式写入。若工作表单元格正则表达式中 <c ...>...</c> 分支排在自闭合分支之前，就会把一个空单元格与下一个有值的单元格合并，导致数值错位到错误的列，将 12 月的数据报告为 4 月。这不会引发任何错误。src/xlsx.ts 中的分支顺序至关重要；其上方的注释也特别说明了这一点。

三份电价工作簿的布局正好相反（月份纵向排列，年份横向排列），而且表头所在行各不相同，因此要通过查找表示“月份”的格鲁吉亚语单词来确定表头，而不是根据位置判断。部分单元格中的文本带有不换行空格。

GNERC 行标签仅使用格鲁吉亚文字——ენგურჰესი 是 Enguri HPP。balance_code 列保留了已发布的层级结构（1.4.1.1 表示受监管水电中的一个电站，该受监管水电隶属于水电，而水电又隶属于总发电量），因此汇总行及其组成电站都会出现，并且可以区分。Excel 会将其中一些代码存储为浮点数，因此 1.1 会变成 1.1000000000000001，并经过标准化处理。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/georgia-energy/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 都指向同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/gse_grid_now \
  -H 'Content-Type: application/json' \
  -d '{}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/gse_grid_now。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

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

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

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

也可以直接运行，以确认它能正常启动：

npx -y @pipeworx/mcp-georgia-energy

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上文网关连接所添加的共享元工具。相同的源码、相同的工具，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

无需直接调用工具，你可以用日常语言提问——此方式既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Georgia Energy data" })

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

更多内容

• 文档和指南
• pipeworx.io

许可证

MIT