Jodi

@pipeworx/jodi

国別の月次石油・天然ガス生産量、消費量、輸入量、輸出量、期末在庫量 — Joint Organisations Data Initiative（APEC/Eurostat/GECF/IEA/IEF/OLADE/OPEC/UNSD）に自己申告された、JODI-OilおよびJODI-Gasの世界データベースです。世界約100か国以上を網羅し、湾岸地域のすべての産油国（サウジアラビア、UAE、クウェート、カタール、オマーン、バーレーン、イラク、イラン）を含みます。

Pipeworx の一部です — AI エージェントを1882以上の稼働中データソースに接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携関係になく、承認も受けておらず、同プロバイダーによる公開物でもありません。

ツール

• jodi_oil_series(country, product?, flow?, months?, end_month?) — 1か国の月次石油系列（原油／NGL／その他／原油合計、または精製製品）。報告の欠落は明示的に示されます。
• jodi_gas_series(country, flow?, months?, end_month?) — 天然ガスについて同様のデータを提供します（生産、LNGとパイプラインに分けた輸出入、需要、在庫）。
• jodi_oil_compare(countries?, product?, flow?, months_back?, end_month?) — 最新の報告月とNか月前の系列の変化量で国を順位付けします。既定では湾岸地域の産油国が対象です。「今四半期に最も生産量を増やした湾岸産油国はどこか」（months_back: 3）にも、「サウジアラビアの輸出量は1年前と比べてどうか」（countries: ["Saudi Arabia"], months_back: 12）にも対応します — 国のリストを変えるだけで、同じ比較を行います。
• jodi_gas_compare(countries?, flow?, months_back?, end_month?) — ガスについて同様の比較を行います。
• jodi_countries(commodity?) — JODI-Oil/Gasの対象国と、各国の最古・最新の報告月を確認します。

認証

キーは不要です。用意する上流キーはありません。

データソース

• https://www.jodidata.org/oil/database/data-downloads.aspx — JODI-Oilの年次CSV（主データ：原油／NGL／その他／原油合計、副データ：精製製品）。年ごとに1ファイルで、2002年から現在までを網羅します。
• https://www.jodidata.org/gas/database/data-downloads.aspx — JODI-Gasの2009年から現在までの全期間を収録した1つのCSV。ファイル名は固定値ではなく、JODI独自のhttps://api.publisher.jodidata.org/web/files/gas JSON APIを通じて特定します（ファイル名はこれまでに一度変更されています）。

workers/data-pipeline/src/datasets/jodi.ts によって月次で取り込まれ、jodi_oil_observations / jodi_gas_observations に格納されます（マイグレーション161）。報告がない場合に保存済みのnullではなく行が欠落する理由や、JODIが公表する5種類の単位のうち、フローごとに1種類だけが取り込み後に残る理由など、設計の詳細はマイグレーションファイルとデータセット設定に記載されています。要点は次のとおりです。

• 月が欠けていても、ゼロを意味するわけではありません。 JODIは自己申告制で、網羅性にはばらつきがあります — 報告が遅れる国、月を飛ばす国、特定の系列を一度も報告しない国があります。ここにあるすべてのツールは、想定される月の全範囲を作成し、存在する行だけを返して欠落を無言で済ませるのではなく、欠落を{reported: false, value: null}と示します。
• 単位はあらかじめ選択されており、ユーザーは選べません。 JODIは各値を5種類の単位で公表します。このパックでは、石油の流量にはKBD（1日あたり千バレル）、2種類のレベルフロー（期末在庫量、在庫変動）にはKBBL（千バレル）を使用します。JODI自身も、この2種類にはKBDを「適用対象外」としています。ガスのすべての項目にはM3（百万立方メートル）を使用します。
• 国名はISO 3166-1 alpha-2コードに基づいています。JODIの元ファイルにはコードのみが含まれるため、このパックでは両方のデータベースに登場するすべてのコードを網羅する独自のコード→名称テーブル（src/index.ts のCOUNTRY_NAMES）を保持します。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/jodi/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 も同じゲートウェイと、同じ 1882 以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。ask_pipeworx を使えば、どちらからでもすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/jodi_oil_series \
  -H 'Content-Type: application/json' \
  -d '{"country":"Saudi Arabia","flow":"exports","months":24}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/jodi_oil_series を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

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

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも必要ありません。

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-jodi

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に対して、このパックのツールのみを返します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールを使いますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。この方法は、上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

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

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT