Heating Oil and Propane Prices MCP

heating-oil-propane-prices-mcp

AI アシスタント向けの暖房用灯油とプロパンの価格です。お住まいの州の今週のガロンあたり価格を尋ねると、米国エネルギー情報局（EIA）の平均価格、先週および前年からの変動、タンクを満タンにする費用がわかります。

これは Model Context Protocol（MCP）サーバーです。呼び出し時に、EIA の週次家庭用暖房用灯油・プロパン調査を読み込みます。API キーは不要です。

ツール

ツール	返される内容
get_heating_oil_propane_prices	今週の米国、EIA 地域、または調査対象州における、家庭用暖房用灯油とプロパンのガロンあたり平均価格（税金込み）、先週からの変動、直近 5 回分の調査週、前年の価格、次回の公表日。
get_heating_fuel_price_history	2 つの日付の間における、燃料と地域ごとの週次価格（ほとんどの系列は 1990 年に始まります）。最高値、最低値、平均値も含まれます。
estimate_heating_fuel_cost	今週の州平均価格（または指定した価格）での配達費用、100 万 Btu あたりの費用、暖房用灯油とプロパンの 100 万 Btu あたりの比較。必要に応じて、電気料金や天然ガス料金との比較もできます。

すべての結果には、構造化 JSON、1 段落の概要、as_of、source、more（mcpstamp.com のページ）が含まれます。

モデルが知らない情報

• 今週の価格。EIA は 10 月から 3 月まで毎週水曜日に新しい価格を公表するため、記憶されている価格は古くなっています。
• EIA が調査する州。暖房用灯油は北東部および中西部の 21 州、プロパンは 38 州が対象です。それ以外の州では、根拠のない価格を作るのではなく、対象州の一覧が返されます。
• EIA の履歴ファイルに基づく、実際の前年同期比の変動。

インストール

ホステッド（Claude.ai カスタムコネクター、ChatGPT デベロッパーモード）

この URL を貼り付けてください。トークンもサインアップも不要で、すぐに使えます。

https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http heating-fuel-prices https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp

Claude Desktop

Claude Desktop では、「Settings」→「Connectors」→「Add custom connector」からリモートサーバーを追加できます。上記の URL を貼り付けてください。

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "heating-fuel-prices": { "url": "https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "heating-fuel-prices": { "type": "http", "url": "https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp" }
  }
}

ローカル stdio（npm リリース後）

npm パッケージはまだ公開されていません。公開後、Node 20 以降を使ってローカルで実行できます。

claude mcp add heating-fuel-prices -- npx -y heating-oil-propane-prices-mcp

プロンプトの例

• 「今週の暖房用灯油の価格はいくらですか？」
• 「今のメイン州のプロパン価格はいくらですか？ 昨年と比べてどうですか？」
• 「コネチカット州で暖房用灯油を 200 ガロン購入すると、いくらかかりますか？」
• 「ペンシルベニア州では、プロパンと暖房用灯油のどちらが Btu あたり安いですか？」
• 「過去 1 年間のミネソタ州のプロパン価格を見せてください。」

データソース

取得日を含む全一覧は、DATA_SOURCES.md をご覧ください。

• 呼び出し時に読み込まれる、EIA の週次家庭用暖房用灯油価格とプロパン価格。
• 前年価格と履歴には、EIA の週次履歴ページ（LeafHandler）を使用します。
• EIA の熱量：暖房用灯油は 1 ガロンあたり 138,500 Btu、プロパンは 1 ガロンあたり 91,452 Btu です。

制限事項

• 州平均価格は販売店調査に基づくもので、見積もり価格ではありません。販売店の価格、配達料、数量、契約条件は異なります。
• 4 月から 9 月までは、EIA は月に 1 回価格を収集します。
• すべての州が調査対象ではありません（たとえば、テキサス州の暖房用灯油価格はありません）。
• ホステッドサーバーでは、EIA のページを最大 1 時間キャッシュします。

詳細

アシスタントだけでは答えられない質問に対応する MCP サーバーは、mcpstamp.com でご覧いただけます。

Zovo MCP コレクションの一部です：https://mcp.zovo.one

theluckystrike が開発しました。

開発

npm install
npm test                              # builds, then runs the fixture tests and an offline stdio test
node scripts/stdio-transcript.mjs     # live stdio round trip, writes .live/stdio-transcript.jsonl

ライセンス

MIT