fuel-mcp

中国油价 MCP

为 AI Agent 提供中国境内成品油（汽油和柴油）价格：查询中国 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 客户端的 mcpServers 配置中（Claude Desktop、Cursor、Cline、Cherry Studio 等）：

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

不接受 "type": "http" 的客户端，可使用相同配置项，只保留 "url"。

🧰 工具

| 工具 | 参数 | 返回内容 | |

---|---|---| | query_oil_price(province="") | province：可选地区名称——全称（山东省）、简称（山东）或单字别称（鲁/京）。省略则返回所有地区。 | 单个地区：92#/95#/98# 汽油和 0# 柴油价格（CNY/升）、数据日期、数据来源、下一轮调价窗口。不传参数：全部 31 个省级地区的价格，以及数据日期和下一轮调价窗口。 |

示例

• “山东今天 92 号汽油多少钱？”→ 山东油价。
• “广东油价”→ 广东油价。
• “全国油价列表”→ 所有地区。

📡 数据

• 服务会按顺序尝试实时数据源（中石油官网、国家发展改革委公告、华尔街见闻大宗商品）；如果均无法获取结构化数据，则回退到内置静态价格表，响应中始终会返回其日期（data_date / data_source 字段）。
• 地区名称支持全称、简称和传统单字别称（京/沪/鲁/粤……）。
• 价格为以 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 号柴油价格（元/升），支持省名全称、简称与单字别称（鲁→山东、京→北京）；不传省份返回全国列表，并给出下一轮调价窗口预估。

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

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

📄 许可证

MIT © 2026 boy-373 (刘扶阳)