fuel-mcp

China Fuel Price MCP

China domestic refined-fuel (gasoline & diesel) prices for AI agents: query pump prices for 92# / 95# / 98# gasoline and 0# diesel in any of China's 31 provincial-level regions, or get the full national list, plus the next expected price-adjustment window.

• Try it in 30 seconds: a free public MCP endpoint is already running — just paste the URL into your MCP client (no install, no API key).
• Or self-host: a small FastMCP server. A bundled static price table (clearly dated) guarantees answers even when no live source is reachable.

⚡ Use the hosted endpoint (no setup)

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

Transport: Streamable HTTP (MCP 2025-03-26 compatible). No authentication required.

🔌 Client configuration

Add this to your MCP client's mcpServers configuration (Claude Desktop, Cursor, Cline, Cherry Studio, etc.):

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

Clients that do not accept "type": "http" accept the same entry with just "url".

🧰 Tools

| Tool | Parameters | Returns | |

---|---|---| | query_oil_price(province="") | province: optional region name — full (山东省), short (山东), or one-character abbreviation (鲁/京). Omit to get all regions. | Single region: 92#/95#/98# gasoline and 0# diesel prices (CNY/liter), data date, data source, next adjustment window. No argument: prices for all 31 provincial-level regions, with data date and next adjustment window. |

Examples

• "山东今天 92 号汽油多少钱？" → Shandong fuel prices.
• "广东油价" → Guangdong prices.
• "全国油价列表" → all regions.

📡 Data

• The server attempts live sources in order (CNPC official site, NDRC announcements, WallStreetCN commodities); when none yields structured data it falls back to a bundled static price table whose date is always returned in the response (data_date / data_source fields).
• Region names accept full names, short names and traditional one-character abbreviations (京/沪/鲁/粤…).
• Prices are reference benchmark prices in CNY per liter; actual pump prices may vary by station and promotions. No API key required.

Adjust the bundled table (STATIC_OIL_PRICES / STATIC_DATA_DATE in fuel_server.py) to refresh figures between releases.

🐢 Self-hosting

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

Then point your MCP client at http://127.0.0.1:8000/mcp.

With uv:

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

🗂️ Files

• fuel_server.py — the MCP server: price table, province-name normalization, live-source attempts with static fallback, FastMCP tool definition.
• server.py — standalone Streamable HTTP entry point (serves the MCP app at /mcp).
• requirements.txt — Python dependencies.
• LICENSE — MIT.

---

🇨🇳 中文说明

国内油价 MCP：查询全国 31 个省区市的 92/95/98 号汽油与 0 号柴油价格（元/升），支持省名全称、简称与单字别称（鲁→山东、京→北京）；不传省份返回全国列表，并给出下一轮调价窗口预估。

在线直连（免费、无需 Key）：https://mcp.pianam.cn/fuel-mcp/mcp

联网数据源不可用时自动降级到内置静态油价表（响应中始终标注数据日期与来源）。价格为参考基准价，实际以当地加油站为准。

📄 License

MIT © 2026 boy-373 (刘扶阳)