cn.pianam.mcp/fuel-mcp

China fuel prices: gasoline and diesel across all 31 provinces with adjustment forecast.

Open source Repository Open in the app JSON README (API)

About

China fuel prices: gasoline and diesel across all 31 provinces with adjustment forecast.

Details

Kind: MCP servers
Topic: Maps, weather & travel
Publisher: cn.pianam.mcp
Origin: official
Category: ferramentas
Transport: http
Version: 1.0.0
Last push: 2026-09-06T02:33:15Z
Repository state: ativo
Language: Python
License: MIT
Added: 2026-09-04 23:00:30
Updated: 2026-09-04 23:00:30
Origin id: cn.pianam.mcp/fuel-mcp

README

# China Fuel Price MCP

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![MCP](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)
[![Remote](https://img.shields.io/badge/Streamable%20HTTP-hosted%20free-success)](https://mcp.pianam.cn/fuel-mcp/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.):

```json
{
  "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 |
|

[![fuel-mcp MCP server](https://glama.ai/mcp/servers/boy-373/fuel-mcp/badges/score.svg)](https://glama.ai/mcp/servers/boy-373/fuel-mcp)

---|---|---|
| `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

```bash
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](https://docs.astral.sh/uv/):

```bash
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](LICENSE) © 2026 boy-373 (刘扶阳)

cn.pianam.mcp/fuel-mcp

About

Details

README

More