japan-jepx-mcp

日本 JEPX 电力现货价格 MCP

提供 JEPX（日本电力交易所）的日本批发电力现货价格 的 MCP 服务——包括 系统（全国）价格和 9 个区域价格，粒度为 30 分钟（每天 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	全天 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	全天价格曲线
GET /rest/history?area=tokyo&days=14	每日平均价格历史记录
GET /rest/cheapest?area=tokyo&limit=5	价格最低的时段／区域
GET /rest/areas	区域列表、单位和每天的时段数
GET /openapi.json	OpenAPI 文档

区域（区域价格顺序）：system（全国）、hokkaido、 tohoku、tokyo、chubu、hokuriku、kinki（又称 kansai）、chugoku、 shikoku、kyushu。支持罗马字和汉字（例如 tokyo／東京）。

使用场景

• 电动汽车充电调度／家用电池套利
• 制造业将负荷转移到电价较低的时段
• 电力市场监控和预测分析
• 日本能源成本基准分析

本地运行

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 安装

只需一条命令，即可将此 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 注册表

此服务已在官方 MCP 注册表中登记。 可通过搜索找到：japan-jepx-mcp

---

数据与商店

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