japan-minimum-wage-mcp

Japan Minimum Wage MCP — 日本各地区最低工资（厚生劳动省官方统计）

这是一个 MCP 服务，可让 AI Agent（Claude、ChatGPT 等）通过 MCP 工具查询厚生劳动省（MHLW）官方统计“各地区最低工资全国一览”中的日本 47 个都道府县的地区最低工资。

大模型的记忆按设计很快就会过时。由于最低工资每年 10 月修订，要回答“当前正确的最低工资”，始终需要使用最新的官方来源。 可用于自动化 HR SaaS、工资计算、合规和成本估算。

提供的工具

工具	内容
get_minimum_wage	指定都道府县最新年度的最低工资时薪＋上一年度金额＋上调金额＋生效日期（也可查询全国加权平均值）
get_minimum_wage_history	指定都道府县过去 N 个年度的修订历史（金額＋生效日期，含 min/max）
rank_minimum_wages	47 个都道府县的时薪排名（从低到高＋从高到低，含全国加权平均值）
list_prefectures	可查询的都道府县名称（汉字、罗马字）、可用年度和最新年度一览

数据

• 来源：厚生劳动省“各地区最低工资全国一览” （https://www.mhlw.go.jp/stf/seisakunitsuite/bunya/koyou_roudou/roudoukijun/minimumichiran/）
• 最新年度：令和 7 年度（2025 年 10 月至 2026 年 3 月期间陆续生效）
• 历史记录：平成 14 年度（2002 年）至令和 7 年度，共 24 个年度
• 全国加权平均值：1,121 日元/小时（令和 7 年度）
• 单位：日元/小时（JPY per hour）
• 许可证：政府标准利用条款 2.0（注明来源即可用于商业用途）

快速开始

uv run src/stdio_main.py          # stdio MCP サーバー（Claude Desktop / Cursor / Smithery）

Claude Desktop 的 claude_desktop_config.json：

{
  "mcpServers": {
    "japan-minimum-wage": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/japan-minimum-wage-mcp", "src/stdio_main.py"]
    }
  }
}

REST（用于 RapidAPI / OpenAPI 网关）

Apify Standby 启动时（uv run -m src.main），除 /mcp（streamable-http）外， 还会公开普通 GET 端点（用于 RapidAPI freemium 发布）：

端点	说明
GET /rest/latest?prefecture=tokyo	最新最低工资
GET /rest/history?prefecture=osaka&years=5	修订历史
GET /rest/rank?limit=10	从低到高排名
GET /rest/prefectures	都道府县和年度一览
GET /openapi.json	OpenAPI 文档

开发

uv venv && uv pip install -e .
uv pip install pytest
python scripts/build_seed.py     # data/minwage.json を MHLW XLSX から再生成
pytest -q                       # 18 tests
python scripts/sync_manifest_tools.py   # manifest.json の tools をサーバーから同期
python scripts/pack_mcpb.py             # server.mcpb（Smithery 公開用）を生成

规格

• 完全本地运行（无需 API 密钥）。从随附的种子缓存（data/minwage.json）即时响应
• 仅在指定 force=True 时重新获取 MHLW 官方 XLSX（每年更新 1 次，因此 TTL 为 24h）
• 采用只读、封闭世界设计（工具不会失败）

Apify Store

此 MCP 服务也在 Apify Store 上提供：

• Apify Store: japan-minimum-wage-mcp — 通过 PPE 计费提供 47 个都道府县的最低工资数据。可在 Apify Store 中点击 Run 按钮立即启动。

---

来源：厚生劳动省“各地区最低工资全国一览”/ Government Standard Terms of Use 2.0.

通过 Smithery 安装

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

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

对于其他客户端，请将 claude 替换为 cursor、vscode 或 cline。

也可以直接从 Smithery 注册表 安装。

注意： Smithery 服务列表正在等待验证。验证完成后，此服务将出现在搜索结果中，并开始跟踪 useCount。

已登记至 MCP 官方注册表

本服务已以 io.github.atushi1841/japan-fuel-price-mcp 的名称登记至 MCP 官方注册表（status: active）。

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

---

数据与商店

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