japan-fuel-price-mcpSAFE
MCP server: Japan weekly gasoline/diesel/kerosene retail prices from METI Agency for Natural Resources and Energy official XLSX (47 prefectures + nationwide, since 1990)
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
MCPサーバー: 日本のガソリン・軽油・灯油の週次小売価格を、資源エネルギー庁(METI)公式統計XLSXからAIエージェントに提供します。
- データソース: 資源エネルギー庁 給油所小売価格調査 公式XLSX(毎週更新、1990年〜の全国・都道府県別平均現金価格)
- 利用規約: 政府標準利用規約2.0(出典明示で商用利用可)
- 単位: ガソリン・軽油 = 円/L、灯油 = 円/18L(消費税込み)
Tools
prefecture は漢字・ローマ字・「都/府/県」付きのいずれでも可(東京 / tokyo / 東京都)。北海道・沖縄はMETI調査の局単位データを都道府県として提供。
動作
- 初回呼び出しで最新
YYMMDDs5.xlsxを取得(ブラウザUA必須)、openpyxlでパースしJSONキャッシュ化 - 以後6時間はキャッシュから即答、TTL切れで新週ファイルをチェック
- METIのレート制限/障害時はビルド時同梱のシードキャッシュ(
data/fuel_prices.json)にフォールバック — ツールが500になることはない
MCP接続
Apify Standby モード(streamable HTTP):
https://api.apify.com/v2/acts//mcp Authorization: Bearer
ローカル開発
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
シード更新(週1回、木曜の公開後):
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
Deploy
GitHub連携 Apify Actor(usesStandbyMode, webServerMcpPath=/mcp)。push後にビルドAPIを叩く:
curl -X POST "https://api.apify.com/v2/acts//builds?version=0.1&tag=latest&token=$APIFY_TOKEN"
出典表記
Source: Agency for Natural Resources and Energy (METI), Petroleum Produc
d8c5d1876b02OBSERVED · 2026-10-09Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add japan-fuel-price-mcp -- uvx japan-fuel-price-mcp
{
"mcpServers": {
"japan-fuel-price-mcp": {
"command": "uvx",
"args": [
"japan-fuel-price-mcp"
]
}
}
}Exposed tools (5)
5 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
cheapest_prefectures | read | Rank Japan |
get_fuel_price_history | read | Get weekly retail fuel price history for a Japanese prefecture or nationwide. |
get_latest_fuel_price | read | Get the latest weekly average retail fuel price for a Japanese prefecture or nationwide. |
list_fuel_regions | read | List all queryable regions (47 prefectures + regional bureaus + nationwide) with romaji aliases, and the 5 fuel products with their units. |
national_fuel_trend | read | Get nationwide weekly fuel price trend across multiple products — an inflation/macro indicator for Japan. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (4 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (5)
.mcpbignore
apify, fastmcp, mcp, uvicorn, openpyxl
curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/builds?version=0.1&tag=latest&token=$APIFY_TOKEN"
data/fuel_prices.json
Gates applied: no_behavioural_pass, no_license.
d8c5d1876b02full audit observations/trust-audit/mcp-server/atushi1841__japan-fuel-price-mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-09 | d8c5d1876b02 | SAFE | B | 89 | first audit |
Questions
What is the japan-fuel-price-mcp MCP server?
MCP server: Japan weekly gasoline/diesel/kerosene retail prices from METI Agency for Natural Resources and Energy official XLSX (47 prefectures + nationwide, since 1990)
What tools does japan-fuel-price-mcp expose?
5 in total: 5 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is japan-fuel-price-mcp safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does japan-fuel-price-mcp need?
No credential environment variables were found in its source, so it appears to need none.
How does japan-fuel-price-mcp run?
It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on PyPI as japan-fuel-price-mcp.
How current is this page?
The grade is for one exact copy of the source (d8c5d1876b02), read on 2026-10-09. The repository is watched and re-audited when it changes.