# SSW Workforce Intelligence MCP Server

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](#english) | [Bahasa Indonesia](#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
```bash
# 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による市場マップ、ギャップチャート、戦略司令塔ダッシュボードを内蔵。

### 起動方法
```bash
# 依存関係のインストール
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
```bash
# Instalasi dependensi
pnpm install

# Bangun proyek
pnpm run build

# Jalankan server Hono (port 8081)
pnpm run start
```

---

## License / ライセンス

Apache License 2.0. See [LICENSE](LICENSE) for details.