How do I install Japan Fuel Price?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Japan Fuel Price need an API key?

No required environment variable is listed on this record.

What transport does Japan Fuel Price use?

Japan Fuel Price runs locally over stdio.

When was Japan Fuel Price last checked?

Last checked 2026-11-09. Japan fuel prices by p Apify:apify.com/fruitful_quintessence | Gumroad:atushi5.gumroad.com/l/kutuxe

Japan Fuel Price MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

mcpb https://github.com/atushi1841/japan-fuel-price-mcp/releases/download/v0.1.0/server.mcpb

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.atushi1841-japan-fuel-price-mcp -- mcpb https://github.com/atushi1841/japan-fuel-price-mcp/releases/download/v0.1.0/server.mcpb

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.atushi1841-japan-fuel-price-mcp": {4      "command": "mcpb",5      "args": [6        "https://github.com/atushi1841/japan-fuel-price-mcp/releases/download/v0.1.0/server.mcpb"7      ]8    }9  }10}

claude_desktop_config.json

Local · mcpbPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.3.6
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Japan Fuel Price MCP — METI Weekly Gasoline / Diesel / Kerosene

MCPサーバー: 日本のガソリン・軽油・灯油の週次小売価格を、資源エネルギー庁（METI）公式統計XLSXからAIエージェントに提供します。

データソース: 資源エネルギー庁給油所小売価格調査公式XLSX（毎週更新、1990年〜の全国・都道府県別平均現金価格）
利用規約: 政府標準利用規約2.0（出典明示で商用利用可）
単位: ガソリン・軽油 = 円/L、灯油 = 円/18L（消費税込み）

Tools

Tool	説明
`get_latest_fuel_price(prefecture, product)`	指定都道府県（または全国）の最新週平均価格 + 前週比 + ガソリン税内訳
`get_fuel_price_history(prefecture, product, weeks)`	週次履歴（都道府県は直近260週、全国は1990年〜）+ min/max/avg
`cheapest_prefectures(product, limit)`	47都道府県最安〜最高値ランキング
`national_fuel_trend(products, weeks)`	全国平均の複数製品トレンド（インフレ/マクロ指標用）
`list_fuel_regions()`	照会可能な地域（漢字+ローマ字）・製品・単位のリスト

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

シード更新（週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/<ACTOR_ID>/builds?version=0.1&tag=latest&token=$APIFY_TOKEN"

出典表記

Source: Agency for Natural Resources and Energy (METI), Petroleum Products Price Survey. Government Standard Terms of Use 2.0.

Install via Smithery

Connect this MCP server to your AI client (Claude Desktop, Cursor, VS Code) in one command:

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

Replace claude with cursor, vscode, or cline for other clients.

Alternatively, install directly from the Smithery registry.

Note: Smithery server listing is pending verification. Once verified, this server will appear in search results with useCount tracking.

MCP公式レジストリ登録済み

本サーバーは MCP 公式レジストリに io.github.atushi1841/japan-ec-mcp として登録済み（status: active）です。

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

Data & Store

Apify Store: https://apify.com/fruitful_quintessence
Gumroad datasets: https://atushi5.gumroad.com/l/kutuxe

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Japan Fuel Price?

Does Japan Fuel Price need an API key?

What transport does Japan Fuel Price use?

When was Japan Fuel Price last checked?

Documentation

Japan Fuel Price MCP — METI Weekly Gasoline / Diesel / Kerosene

Tools

動作

MCP接続

ローカル開発

Deploy

出典表記

Install via Smithery

MCP公式レジストリ登録済み

Data & Store