mcp-karyawan

Demo sederhana MCP (Model Context Protocol) server berupa CRUD data karyawan. Dibuat untuk belajar/mengajar konsep dasar MCP tool.

Lokasi server

Seluruh server ada di satu file: main.py. Server dibuat dengan FastMCP dari SDK resmi mcp[cli], dan data karyawan disimpan in-memory (list Python) — reset tiap server di-restart.

Tools yang tersedia

Tool	Fungsi
create_karyawan	Tambah data karyawan baru (id digenerate otomatis pakai uuid)
list_karyawan	Tampilkan semua data karyawan
get_karyawan	Ambil satu data karyawan berdasarkan id
update_karyawan	Ubah sebagian field karyawan berdasarkan id (partial update)
delete_karyawan	Hapus data karyawan berdasarkan id

Instalasi & Menghubungkan ke Claude Desktop

Pilih salah satu, tergantung tool yang biasa kamu pakai. Keduanya berakhir di langkah yang sama: mendaftarkan server ke Claude Desktop lewat command mcp install.

Opsi A — pakai uv

uv sync
uv run mcp install main.py --name karyawan

Opsi B — pakai pip

python -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate
pip install "mcp[cli]>=1.28.1"
mcp install main.py --name karyawan

Setelah salah satu opsi di atas dijalankan, restart Claude Desktop. Tool create_karyawan, list_karyawan, get_karyawan, update_karyawan, dan delete_karyawan akan otomatis tersedia untuk dipanggil Claude di chat.

<details> <summary>Cara manual (kalau command <code>mcp install</code> tidak bisa dipakai)</summary>

1. Buka file konfigurasi Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Tambahkan entry berikut (ganti /ABSOLUTE/PATH/TO/mcp-karyawan dengan path absolut repo ini):

   {
     "mcpServers": {
       "karyawan": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/mcp-karyawan",
           "run",
           "main.py"
         ]
       }
     }
   }
   

   Kalau pakai pip (bukan uv), ganti "command" dengan path Python di dalam venv-mu, misalnya:

   {
     "mcpServers": {
       "karyawan": {
         "command": "/ABSOLUTE/PATH/TO/mcp-karyawan/venv/bin/python",
         "args": ["/ABSOLUTE/PATH/TO/mcp-karyawan/main.py"]
       }
     }
   }
   

3. Restart Claude Desktop.

</details>