io.github.atushi1841/japan-minimum-wage-mcp

Japan Minimum Wage MCP — 日本の地域別最低賃金（厚生労働省 公式統計）

MHLW（厚生労働省）公式統計「地域別最低賃金の全国一覧」から、日本の 47 都道府県の地域別最低賃金 を AI エージェント（Claude, ChatGPT 等）から MCP ツールとして照会できるサーバーです。

LLM の記憶は設計上すぐに古くなります。最低賃金は毎年 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）
• 読み取り専用・閉世界（ツールは失敗しない）設計

---

出典: 厚生労働省「地域別最低賃金の全国一覧」/ Government Standard Terms of Use 2.0.