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.

Related MCP server: MCP Playground

Tools yang tersedia

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.

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.