Georgia Energy

@pipeworx/georgia-energy

ジョージア（国）の全国電力システム：送電系統運用者からのリアルタイム系統テレメトリーと、規制当局による発電所ごとの月次発電量・価格の時系列データです。

Pipeworx の一部です。AI エージェントを1879以上のリアルタイムデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流の提供元とは提携しておらず、承認や公開も受けていません。

ツール

• gse_grid_now(...) — 最新公開済みの3分枠時点の系統データ： 水力／火力／風力／太陽光の発電量、総発電量、アゼルバイジャン、アルメニア、ロシア（サルキノ、ジャヴァ、ナカドゥリの各送電線を個別表示）、トルコとの連系線の越境潮流、総消費量（MW）。
• gse_grid_at(...) — ローリング約30日間の保持期間内にある、指定した過去の1枠分の同じデータ。
• gse_frequency(...) — 系統周波数（Hz、定格50）、1分間隔のデータです。50 Hzからの偏差は、発電量と需要の均衡を直接示します。
• gse_demand_forecast(...) — 翌日予測を1時間ごとに表示します：消費量、供給量、火力、水力（調整式および季節式）、風力、輸入、輸出。
• gse_publications(...) — 発電適正評価、年次報告書、SESAなど、運用者の報告書や告知です。
• gse_tenders(...) — 運用者の調達入札。公開されている場合は、落札者と入札価格も含みます。
• gnerc_station_generation(...) — 2015～2026年の発電所ごとの月次発電量（エングリ、ヴァルドニリ・カスケード、フラミ1／2、ジンヴァリ、ガルダバニ火力1／2、カルトリ風力発電所、名称付きの太陽光発電所）に加え、国内供給量、消費量、輸入、輸出、名称付きの大規模直接消費者のデータです。
• gnerc_prices(...) — 2015～2026年の月次調整電力価格、保証容量料金、ESCOが規制対象外発電所に支払った価格です。

認証

認証情報は不要です。どちらの公開元でも、トークン、Cookie、登録は必要ありません。

データソース

• https://admin.gse.com.ge/storage/uploads/fact/ — JSC Georgian State Electrosystem（GSE）のリアルタイム系統エクスポートです。GSE_EXPORT_NEW_PERIOD_03M_*.XML は3分ごと、GSE_EXPORT_PERIOD_01M_*.XML（周波数）は1分ごとです。
• 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/ — Georgian National Energy and Water Supply Regulatory Commission（GNERC）のオープンデータ・ワークブックです。

後から苦労して再発見することになる事項

**GSE のファイル名は UTC ではなく、トビリシの現地時間（UTC+4）**で、分は 3 分単位で切り捨てられ、公開にも遅延があります。現在の分を要求するとエラーではなく 404 が返るため、「現在」とは「存在する最新の時間枠」を意味します。そのため、読み取りのたびに過去へさかのぼり、まず file-exists で時間枠の存在を確認します。遅延は、元のサンプルが示していた約 2 分ではありません。1 分間隔のフィードでは、9～10 時間枠遅れていることが確認されています。そのため、探索では並行バッチでプローブします。トビリシへの逐次ラウンドトリップを 10 回行うと約 4 秒かかり、そのほとんどは応答待ちです。

テレメーターで送信されたすべての値には QUALITY 属性が付いており、その大部分は測定値ではありません。 ACT は実際のテレメトリー、SUB は運用者によって代替された値、NRE は未受信を示します。代表的なライブエクスポートでは、ACT が 3 件、SUB が 7 件、NRE が 3 件でした。全国消費量は 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 ランタイム上で依存関係なしに、これと OOXML .xlsx の両方を処理します。

data.gnerc.org は中間証明書を付けずにリーフ証明書を送信します。 Node に同梱されている CA ストアでは証明書チェーンを構築できず、UNABLE_TO_VERIFY_LEAF_SIGNATURE で失敗するため、Worker の外でこのパックをテストするローカルスクリプトでは、サイトがダウンしているように見えます。Cloudflare の送信トラフィックでは正常に名前解決できます（2026-09-10 に独自のゲートウェイで実際に確認済み）。ホストを変更して「修正」しないでください。代替ホストも同じ単一証明書のチェーンを提供し、gnerc.org/excel/ は 500 を返します。

GNERC の収支ワークブックは約 450 KBあるため、呼び出しごとにダウンロードするのではなく、アイソレートごとに一度取得・解析し、6 時間キャッシュされます。

収支シートでは、列 C～N が 1 月～12 月、列 O が年間合計です。ただし、空の月は値のない自己終了セルとして記録されています。<c ...>...</c> のパターンを自己終了セルのパターンより先に置いたワークシートセル用正規表現では、空のセルが次のデータ入りセルと結合され、値が誤った列にずれて、12 月の値が 4 月の値として報告されることがあります。エラーは発生しません。src/xlsx.ts の順序は結果を左右するため、その直上の注記でも説明しています。

3 つの価格ワークブックは逆の構成（行に月、列に年）で、ヘッダーがどの行にあるかもそれぞれ異なります。そのため、位置ではなく、グルジア語で「月」を意味する単語を探してヘッダーを特定します。一部のセルのテキストには、ノーブレークスペースがパディングされています。

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 を介してカタログ全体を対象にルーティングできるため、このパックが扱わない質問にも、2 つ目の MCP サーバーを追加せずに回答できます。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによって増えるコンテキストのコストが、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

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

どちらの URL も同じゲートウェイと同じ 1879+ のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらの URL からも、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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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