japan-jepx-mcp

Japan JEPX Electricity Spot Price MCP

JEPX（日本卸電力取引所）の日本の卸電力スポット価格を公開する MCP サーバーです。システム価格（全国価格）と9つの地域エリア価格を、30分単位（1日48コマ）でJPY/kWhで提供します。

データソースは、JEPX のスポット精算価格（政府標準利用規約）と、地域別の価格差を算出するための OCCTO エリア価格予測です。同梱のシードキャッシュ（data/jepx_spot.json、約400日 × 48コマ = 19,200件）により、オフライン時やフォールバック時にも回答できます。JEPX.org へのライブ取得を試み、サイトが IP 制限されている場合はシードに適切にフォールバックします。

出力例

{
  "date": "2026-09-17",
  "area": "tokyo",
  "area_label": "東京 (Tokyo)",
  "price": 15.24,
  "unit": "JPY/kWh",
  "period": 48
}

ツール（MCP、5種類）

ツール	説明
get_latest_spot_price	エリアの最新スポット価格（デフォルトは tokyo）
get_spot_price_by_day	1日分の48コマの価格推移と最小値／最大値／平均値
get_spot_price_history	日次平均の履歴（期間内の最小値／最大値／平均値）
get_cheapest_spot	最安の30分枠、または最安エリアのランキング
list_spot_areas	エリア一覧、単位、最新日

REST エンドポイント（OpenAPI ゲートウェイ）

エンドポイント	説明
GET /rest/latest?area=tokyo	最新スポット価格（数値）
GET /rest/date?area=tokyo&date=YYYY-MM-DD	1日分の価格推移
GET /rest/history?area=tokyo&days=14	日次平均の履歴
GET /rest/cheapest?area=tokyo&limit=5	最安の時間枠／エリア
GET /rest/areas	エリア一覧、単位、1日あたりのコマ数
GET /openapi.json	OpenAPI ドキュメント

エリア（地域価格の順序）：system（全国）、hokkaido、tohoku、tokyo、chubu、hokuriku、kinki（別名 kansai）、chugoku、shikoku、kyushu。ローマ字と漢字（例：tokyo ／ 東京）のどちらも使用できます。

ユースケース

• EV 充電スケジュールの最適化／家庭用蓄電池の裁定取引
• 安価な時間帯への製造負荷のシフト
• 電力市場のモニタリングと予測分析
• 日本のエネルギーコストのベンチマーク

ローカルでの実行

uv run --directory . src/stdio_main.py   # stdio MCP (Claude Desktop / Cursor)
# or REST-only smoke against the seed:
JEPX_DATA_DIR=/tmp/jepx-smoke python3 smoke_rest.py

デプロイ

Apify Actor japan-jepx-mcp（Standby モード、webServerMcpPath=/mcp、 Dockerfile CMD ["python", "-m", "src.main"]）： https://fruitful-quintessence--japan-jepx-mcp.apify.actor/mcp

Apify Store

この MCP サーバーは、マネージド Apify Actor としても利用できます。

• Apify Store: japan-jepx-mcp — JEPX の日本卸電力スポット価格（PPE课金）。Apify Store から実行し（Run ボタン）、MCP クライアントの接続先にエンドポイントを指定してください。

データとクレジット表記

• ソース：JEPX（日本卸電力取引所）のスポット市場精算価格 — jepx.org · OCCTO の需給エリア価格予測 — occto.or.jp
• データライセンス：政府標準利用規約（出典明示で商用利用可）
• 単位：JPY/kWh（円/kWh）、取引日あたり48 × 30分コマ

Smithery 経由でインストール

次の1コマンドで、この MCP サーバーを AI クライアント（Claude Desktop、Cursor、VS Code）に接続できます。

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

ほかのクライアントでは、claude を cursor、vscode、または cline に置き換えてください。

または、Smithery レジストリから直接インストールしてください。

注： Smithery へのサーバー掲載は、現在検証待ちです。検証が完了すると、このサーバーは useCount の追跡とともに検索結果に表示されます。

MCP Registry

このサーバーは公式の MCP Registry に登録されています。 検索するにはこちらをご覧ください：japan-jepx-mcp

---

データとストア

• Apify Store： https://apify.com/fruitful_quintessence
• Gumroad データセット： https://atushi5.gumroad.com/l/kutuxe