员工数据集成工具

HR Employee MCP Server v2.0.0

FastAPI server yang meng-expose data karyawan sebagai 38 MCP tools untuk integrasi dengan Dify.
Di-deploy di Vercel, terhubung ke Dify sebagai Custom Tool via OpenAPI schema.

Struktur Project

hr-mcp-server/
├── app/
│   └── main.py                                  # FastAPI app — semua 38 tools
├── data/
│   ├── employee_data_20260417.csv                # Dataset karyawan (wajib di-commit!)
│   └── all_employee_training_data_20260417.csv   # Dataset training (wajib di-commit!)
├── requirements.txt
├── vercel.json
└── README.md

Quick Start (Local)

pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

Buka http://localhost:8000/docs untuk test semua tools secara interaktif via Swagger UI.

Deploy ke Vercel

Step 1 — Push ke GitHub

git init
git add .
git commit -m "HR MCP Server v2.0.0"
git remote add origin https://github.com/YOUR_USER/hr-mcp-server.git
git push -u origin main

Penting: Pastikan folder data/ ikut di-commit. File CSV adalah sumber data utama.

Step 2 — Import ke Vercel

1. Buka https://vercel.com → New Project
2. Import repo GitHub kamu
3. Framework: pilih Other
4. Root directory: / (default)
5. Klik Deploy

Server akan live di: https://hr-mcp-server.vercel.app

Integrasi ke Dify

Step 1 — Tambah Custom Tool

1. Di Dify, masuk ke Tools → Custom Tools → Create Tool
2. Pilih Import from OpenAPI Schema
3. Masukkan URL:
   复制

   https://hr-mcp-server.vercel.app/openapi.json
   

4. Klik Import — semua 38 tools akan muncul otomatis.

Step 2 — Tambahkan ke Agent/Chatflow

1. Buka Agent atau Chatflow kamu
2. Di bagian Tools, aktifkan tools HR yang diinginkan
3. Tambahkan system prompt berikut:

Kamu adalah asisten HR yang membantu menjawab pertanyaan tentang data karyawan.
Gunakan tools yang tersedia untuk mengambil data terkini.
Jawab selalu dalam Bahasa Indonesia yang natural dan informatif.
Sertakan angka spesifik dari data, bukan perkiraan.
Jika pertanyaan tidak bisa dijawab dari data yang ada, jelaskan datanya tidak tersedia.

38 Tools — Referensi Lengkap

Group 1 — Headcount & Summary

Group 2 — Contracts & Lifecycle

Group 3 — Resign & Turnover

Group 4 — Search & Roster

Group 5 — Assignment Gaps

Group 6 — Training

Data dari data/all_employee_training_data_20260417.csv. Lulus = post_test_grade >= 90.

Query Parameters Detail

contracts_expiring

new_hires

resigned_employees

resign_by_position

turnover_per_outlet

probation_employees

unassigned_employees

headcount_per_outlet, headcount_per_level, headcount_per_branch, list_by_department, list_by_outlet

Pertanyaan yang Belum Bisa Dijawab

Pertanyaan berikut memerlukan data tambahan yang tidak ada di CSV saat ini:

Update Data

Karyawan: Ganti data/employee_data.csv dengan export terbaru, lalu redeploy ke Vercel.

Training: Ganti data/all_employee_training_data_20260417.csv dengan file baru, update nilai TRAINING_DATA_PATH di app/main.py jika nama file berubah, lalu redeploy.

Server membaca CSV setiap request — tidak perlu database.

Format kolom CSV yang diharapkan:

Catatan Production

Jika jumlah karyawan sudah besar (>1000 baris) atau data sering berubah, pertimbangkan:

• Ganti CSV dengan PostgreSQL / Supabase
• Tambahkan autentikasi API key di header
• Setup caching (Redis) untuk query yang sering dipanggil
• Tambahkan logging per request untuk audit trail