japan-fuel-price-mcp

日本燃油价格 MCP — METI 每周汽油 / 柴油 / 煤油

MCP 服务：从资源能源厅（METI）官方统计 XLSX 中获取日本汽油、柴油和煤油的每周零售价格，并提供给 AI Agent。

• 数据来源：资源能源厅加油站零售价格调查 官方 XLSX（每周更新，包含自 1990 年起的全国及都道府县平均现金价格）
• 使用条款：政府标准使用条款 2.0（注明来源即可用于商业用途）
• 单位：汽油、柴油 = 日元/L，煤油 = 日元/18 L（含消费税）

工具

工具	说明
get_latest_fuel_price(prefecture, product)	指定都道府县（或全国）的最新周平均价格 + 与前一周的差值 + 汽油税明细
get_fuel_price_history(prefecture, product, weeks)	每周历史记录（都道府县为最近 260 周，全国自 1990 年起）+ 最小值/最大值/平均值
cheapest_prefectures(product, limit)	47 个都道府县从最低到最高的价格排名
national_fuel_trend(products, weeks)	全国平均价格的多种产品趋势（适用于通胀/宏观指标）
list_fuel_regions()	可查询地区（汉字 + 罗马字）、产品和单位列表

prefecture 可使用汉字、罗马字或带「都/府/县」的名称（东京 / tokyo / 东京都）。北海道和冲绳以 METI 调查中的局级数据作为都道府县提供。

工作方式

1. 首次调用时获取最新的 YYMMDDs5.xlsx（必须使用浏览器 UA），用 openpyxl 解析并缓存为 JSON
2. 此后 6 小时内直接从缓存返回结果；TTL 到期后检查是否有新周文件
3. METI 限流或发生故障时，回退到构建时随附的种子缓存（data/fuel_prices.json）——工具不会返回 500 错误

MCP 连接

Apify Standby 模式（streamable HTTP）：

https://api.apify.com/v2/acts/<ACTOR_ID>/mcp
Authorization: Bearer <APIFY_TOKEN>

本地开发

pip install -r requirements.txt
python3 -m pytest tests/ -q          # 14 tests, network-stubbed, seed cache
PORT=3999 python3 -m src.main &      # shim経由でApify SDK不要
python3 tests/http_smoke.py http://localhost:3999/mcp

更新种子数据（每周一次，在周四发布后）：

python3 scripts/refresh_seed.py          # METIから取得して data/fuel_prices.json 再生成
python3 scripts/refresh_seed.py path/to/YYMMDDs5.xlsx   # 手元DL分から生成（レート制限回避）
git add data/fuel_prices.json && git commit -m "data: seed refresh" && git push

部署

通过 GitHub 连接的 Apify Actor（usesStandbyMode, webServerMcpPath=/mcp）。推送后调用构建 API：

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/builds?version=0.1&tag=latest&token=$APIFY_TOKEN"

来源标注

来源：资源能源厅（METI），石油产品价格调查。政府标准使用条款 2.0。

通过 Smithery 安装

只需一条命令，即可将此 MCP 服务连接到你的 AI 客户端（Claude Desktop、Cursor、VS Code）：

npx @smithery/cli install atushi1841/japan-fuel-price-mcp --client claude

其他客户端可将 claude 替换为 cursor、vscode 或 cline。

或者，直接从 Smithery 注册表 安装。

注意： Smithery 服务列表正在等待验证。验证通过后，此服务将显示在搜索结果中，并跟踪 useCount。

已注册到 MCP 官方注册表

此服务已以 io.github.atushi1841/japan-ec-mcp 的名称注册到 MCP 官方注册表（status: active）。

# レジストリでの登録確認
curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=atushi1841" | grep -o "\"io.github.atushi1841/japan-ec-mcp\""

---

数据与商店

• Apify Store： https://apify.com/fruitful_quintessence
• Gumroad 数据集： https://atushi5.gumroad.com/l/kutuxe