SSW Workforce Intelligence

A Model Context Protocol (MCP) server providing comprehensive workforce and labor market analysis for Specified Skilled Workers (SSW / 特定技能) in Japan. It aggregates and cross-analyzes public census databases (e-Stat, Ministry of Justice, MAFF, MHLW) with local scoring models.

日本語 | English | Bahasa Indonesia

---

English

Features

• Regional & Industry Analysis: Retrieve detailed counts of active SSW residents by prefecture and industry.
• Labor Supply & Demand Gap: Calculate gap scores between agricultural/industrial output and active support organizations.
• Competitive Landscape: Check the density of support organizations per prefecture and locate underserved markets.
• Wage Insights: Access historical wage progression, industry-specific wages, and local minimum wage premiums.
• Interactive UI (MCP Apps): Built-in rich dashboards including Market Map, Gap Bar Chart, and Command Center.

Quick Start

# Install dependencies
pnpm install

# Build
pnpm run build

# Start Hono server (port 8081)
pnpm run start

Environment Variables

• ESTAT_APP_ID: e-Stat API Application ID (optional, falls back to local CSVs if omitted).
• PORT: Server port (default: 8081).
• SLACK_WEBHOOK_URL: Optional Slack webhook for error alerts.

---

日本語

特定技能（SSW）在留外国人の労働力市場分析を提供する Model Context Protocol (MCP) サーバーです。出入国在留管理庁、農林水産省、厚生労働省などの公的統計（e-Stat）データを統合・分析し、地域・分野別の需給ギャップ、支援機関の競合密度、賃金水準の予測値などを提供します。

特長

• 地域・分野統計: 都道府県別・特定技能分野別の在留者数を取得。
• 需給ギャップ分析: 地域の生産力と外国人受入状況から手薄なエリア（ギャップ）を可視化。
• 競合分析: 都道府県ごとの登録支援機関数と在留外国人数の比率から、市場の競合密度を計算。
• 賃金インサイト: 在留資格別・産業別の平均賃金推移、地域最低賃金との比較プレミアムの算出。
• インタラクティブUI (MCP Apps): D3.jsによる市場マップ、ギャップチャート、戦略司令塔ダッシュボードを内蔵。

起動方法

# 依存関係のインストール
pnpm install

# ビルド
pnpm run build

# Honoサーバー起動 (ポート8081)
pnpm run start

---

Bahasa Indonesia

Server Model Context Protocol (MCP) yang menyediakan analisis komprehensif pasar tenaga kerja untuk Pekerja Terampil Khusus (SSW / Tokutei Ginou) di Jepang. Server ini menggabungkan dan menganalisis statistik publik (e-Stat, Imigrasi Jepang, MAFF, MHLW) dengan model penilaian lokal.

Fitur Utama

• Analisis Wilayah & Industri: Mendapatkan jumlah penduduk SSW aktif per prefektur dan bidang industri.
• Kesenjangan Pasokan & Permintaan: Menghitung skor kesenjangan antara output produksi dan organisasi pendukung aktif.
• Analisis Kepadatan Kompetisi: Memeriksa kepadatan organisasi pendukung terdaftar per prefektur.
• Informasi Upah: Akses tren upah historis pekerja asing dan premium terhadap Upah Minimum Regional (UMR).
• UI Interaktif (MCP Apps): Dashboard visual D3.js terintegrasi seperti Peta Pasar, Grafik Batang, dan Pusat Komando.

Cara Menjalankan

# Instalasi dependensi
pnpm install

# Bangun proyek
pnpm run build

# Jalankan server Hono (port 8081)
pnpm run start

---

License / ライセンス

Apache License 2.0. See LICENSE for details.