Server MCP

nusaindex-mcp adalah server Model Context Protocol yang jalan lokal lewat stdio. Semua tool-nya cuma membaca, tanpa akses ke file system, shell, atau jaringan.

Setup

Butuh Node.js 22.18 ke atas. Servernya jalan di komputer kamu sendiri dan siap dalam kurang dari 300 ms. Pilih aplikasi yang kamu pakai.

Claude Code

Jalankan perintah ini di terminal:

claude mcp add nusaindex -- npx -y nusaindex-mcp

Cek dengan claude mcp list. Kalau berhasil, statusnya ✔ Connected.

Claude Desktop

Buka Settings → Developer → Edit Config, lalu tambahkan:

{
  "mcpServers": {
    "nusaindex": {
      "command": "npx",
      "args": ["-y", "nusaindex-mcp"]
    }
  }
}

Tutup Claude Desktop sampai benar-benar keluar (Quit dari tray), lalu buka lagi.

Cursor

Simpan di ~/.cursor/mcp.json supaya aktif di semua proyek, atau di .cursor/mcp.json kalau cuma untuk satu proyek:

{
  "mcpServers": {
    "nusaindex": {
      "command": "npx",
      "args": ["-y", "nusaindex-mcp"]
    }
  }
}

Buka pengaturan MCP di Cursor. nusaindex harus muncul dengan 10 tool.

VS Code

Copilot di VS Code memakai kunci servers, bukan mcpServers. Simpan di .vscode/mcp.json:

{
  "servers": {
    "nusaindex": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "nusaindex-mcp"]
    }
  }
}

Buka Copilot Chat dalam mode Agent, lalu nyalakan nusaindex lewat tombol tools.

Codex

Jalankan perintah ini di terminal:

codex mcp add nusaindex -- npx -y nusaindex-mcp

Atau tulis sendiri di ~/.codex/config.toml:

[mcp_servers.nusaindex]
command = "npx"
args = ["-y", "nusaindex-mcp"]

Lainnya

Windsurf (~/.codeium/windsurf/mcp_config.json) dan Gemini CLI (~/.gemini/settings.json) memakai format mcpServers yang sama dengan Claude Desktop. Aplikasi lain yang mendukung server MCP lokal (stdio) biasanya juga bisa pakai format itu.

Windows

Kalau aplikasinya gagal menjalankan npx, ganti "command": "npx" jadi "command": "cmd", lalu isi args dengan ["/c", "npx", "-y", "nusaindex-mcp"].

Versi web

Grok, ChatGPT, dan Claude versi web cuma bisa tersambung ke server MCP online. nusaindex-mcp sengaja jalan lokal saja supaya data yang kamu cek tidak lewat server siapa pun. Jadi pakai aplikasi desktop atau CLI.

Tool

Tool	Input	Hasil
validate	kind, values (1 sampai 100)	Valid atau kode error untuk setiap nilai
parse	kind, value	Field hasil parse, plus nama wilayah untuk NIK
region_search	query, opsional level, within, limit	Wilayah yang cocok, terbaik dulu
region_get	code, opsional children	Satu wilayah, plus resolved kalau kode lama diikuti
holidays	year, atau from dan to	Libur beserta dasar hukumnya
workdays	operation (is, add, count), date, days atau to	Hasil perhitungan hari kerja
rupiah	operation (format, parse, terbilang), amount atau text	Teks format, angka, atau terbilang
bank	opsional code atau bic, tanpa keduanya tampil semua	Bank yang cocok
mask	kind dan values (1 sampai 100), atau text	Nilai atau teks yang sudah di-mask
fake	kind, opsional seed, count (maks 20), region, birthDate, sex	Data uji (hanya untuk pengujian)

Untuk validate dan parse, kind bisa nik, npwp, phone, plate, nip, atau nisn. mask menerima account sebagai ganti plate. Setiap tool mengembalikan structured content plus data yang sama dalam bentuk teks JSON.

Privasi

Perhatian

Apa pun yang kamu ketik di chat AI sudah terkirim ke penyedia AI sebelum sampai ke server lokal ini. Jangan tempel NIK, NPWP, atau nomor HP asli ke chat. Untuk demo, minta agent pakai tool fake.

Server tidak pernah me-log atau menyimpan input. Deskripsi tool juga memuat peringatan ini supaya agent bisa ikut mengingatkan. Valid artinya strukturnya benar, bukan berarti nomornya asli.

Contoh prompt

• “Buat 5 NIK palsu untuk perempuan kelahiran 1990 di Kota Bandung, lalu cek apakah valid.”
• “Berapa hari kerja di Agustus 2026, dan libur apa saja di bulan itu?”
• “Terbilangnya Rp1.250.000 apa?”
• “Kabupaten mana saja yang memakai kode plat DR?”