fuel-mcp

中国燃料価格 MCP

中国国内の精製燃料（ガソリンとディーゼル）の価格を AI エージェント向けに提供します。中国の31の省級地域のいずれかで、92#／95#／98#ガソリンと0#ディーゼルの店頭価格を照会したり、全国の一覧や、次回の価格調整予定期間を取得したりできます。

• 30秒で試す：無料の公開 MCP エンドポイントがすでに稼働しています。URLを MCP クライアントに貼り付けるだけです（インストールも API キーも不要です）。
• またはセルフホスト：小規模な FastMCP サーバーです。明確な日付付きの静的価格表が組み込まれており、リアルタイムの情報源に接続できない場合でも回答できます。

⚡ ホストされたエンドポイントを利用する（設定不要）

https://mcp.pianam.cn/fuel-mcp/mcp

トランスポート：Streamable HTTP（MCP 2025-03-26 対応）。認証は不要です。

🔌 クライアントの設定

お使いの MCP クライアント（Claude Desktop、Cursor、Cline、Cherry Studio など）の mcpServers 設定に、以下を追加します。

{
  "mcpServers": {
    "fuel": {
      "type": "http",
      "url": "https://mcp.pianam.cn/fuel-mcp/mcp"
    }
  }
}

"type": "http" を受け付けないクライアントでは、同じ設定項目から "type" を削除し、"url" のみを指定してください。

🧰 ツール

| ツール | パラメーター | 戻り値 | |

---|---|---| | query_oil_price(province="") | province：省略可能な地域名。正式名称（山东省）、略称（山东）、または1文字の略称（鲁／京）を指定します。省略すると、全地域の情報を取得します。 | 単一地域：92#／95#／98#ガソリンと0#ディーゼルの価格（CNY／リットル）、データ日付、データソース、次回の価格調整予定期間。引数なし：データ日付と次回の価格調整予定期間を含む、31の省級地域すべての価格。 |

例

• 「山東省の今日の92号ガソリンはいくらですか？」→ 山東省の燃料価格。
• 「広東省の燃料価格」→ 広東省の価格。
• 「全国の燃料価格一覧」→ 全地域。

📡 データ

• サーバーは、CNPC公式サイト、NDRCの発表、WallStreetCNの商品情報の順にリアルタイムの情報源を試します。構造化データを取得できない場合は、組み込みの静的価格表にフォールバックします。その日付は常にレスポンスの data_date／data_source フィールドに返されます。
• 地域名には、正式名称、略称、1文字の伝統的な略称（京／沪／鲁／粤…）を使用できます。
• 価格は**1リットルあたりの人民元（CNY）**で示す参考基準価格です。実際の店頭価格は、スタンドやキャンペーンによって異なる場合があります。API キーは不要です。

リリース間に数値を更新するには、fuel_server.py の組み込みテーブル（STATIC_OIL_PRICES／STATIC_DATA_DATE）を編集してください。

🐢 セルフホスト

git clone https://github.com/boy-373/fuel-mcp.git
cd fuel-mcp
pip install -r requirements.txt
python server.py
# listens on 127.0.0.1:8000 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python server.py
# behind a reverse proxy, allow your public hostname:
#   MCP_ALLOWED_HOSTS="your-domain.com,your-domain.com:*" python server.py

次に、MCP クライアントの接続先として http://127.0.0.1:8000/mcp を指定します。

uv を使う場合：

uv venv && uv pip install -r requirements.txt
uv run python server.py

🗂️ ファイル

• fuel_server.py — MCP サーバー本体。価格表、省名の正規化、静的データへのフォールバックを伴うリアルタイム情報源への接続処理、FastMCP ツール定義を含みます。
• server.py — 単独で動作する Streamable HTTP エントリーポイント（/mcp で MCP アプリを提供します）。
• requirements.txt — Python の依存関係。
• LICENSE — MIT。

---

🇨🇳 中国語の説明

中国国内の燃料価格 MCP：全国31の省・自治区・直轄市の92／95／98号ガソリンと0号ディーゼルの価格（元／リットル）を照会できます。省名の正式名称、略称、1文字の別称（鲁→山東、京→北京）に対応しています。省を指定しない場合は全国一覧を返し、次回の価格調整予定期間も示します。

オンラインで直接接続（無料、キー不要）：https://mcp.pianam.cn/fuel-mcp/mcp

オンラインのデータソースが利用できない場合は、組み込みの静的燃料価格表に自動で切り替わります（レスポンスには常にデータの日付とソースが記載されます）。価格は参考基準価格です。実際の価格は現地のガソリンスタンドをご確認ください。

📄 ライセンス

MIT © 2026 boy-373 (刘扶阳)