5 MCP server untuk data Indonesia: gempa & cuaca BMKG, kode wilayah, hari libur, Rupiah, dan QRIS
Terbit · 4 menit baca
Pengungkapan: artikel ini ditulis tim Ezkielyna, gateway API AI independen. Kelima server di bawah dibuat oleh tim kami, gratis, berlisensi MIT, dan tidak memerlukan Ezkielyna atau API key apa pun. Draf dibuat dengan bantuan AI, lalu disunting tim kami.
Asisten AI pintar menulis kode, tetapi sering keliru soal hal yang sangat lokal:
- kapan cuti bersama;
- kode kelurahan untuk prakiraan cuaca;
- cara menulis "satu juta lima ratus ribu dua ratus lima puluh rupiah" di kuitansi;
- apakah string QRIS yang ditempel pelanggan itu valid.
Model Context Protocol (MCP) memecahkan ini dengan memberi asisten "alat" yang memanggil data atau fungsi yang benar. Berikut lima server MCP untuk data Indonesia yang kami rilis November 2026.
Ringkasan
| Server | Fungsinya | Internet? | Tools |
|---|---|---|---|
mcp-bmkg | Gempa terbaru, gempa dirasakan, gempa M5+, prakiraan cuaca per desa/kelurahan | ya (data terbuka BMKG) | gempa_terbaru, gempa_dirasakan, gempa_m5, prakiraan_cuaca |
mcp-wilayah-indonesia | 91.599 kode wilayah Kemendagri, offline | tidak | cari_wilayah, detail_kode, daftar_anak, validasi_kode |
mcp-hari-libur-indonesia | Libur nasional dan cuti bersama 2025–2027, hitung hari kerja | tidak | daftar_libur, cek_tanggal, hitung_hari_kerja, hari_kerja_berikutnya |
mcp-rupiah | Terbilang, format dan parse Rupiah, hitung PPN | tidak | terbilang, format_rupiah, parse_rupiah, hitung_ppn |
mcp-qris | Baca dan validasi QRIS, isi nominal, buat SVG | tidak | parse_qris, validate_qris, set_qris_amount, qris_to_svg |
Semuanya satu file JavaScript tanpa dependency, berjalan di Node.js 18 ke atas, dan terdaftar di npm serta MCP Registry dengan nama io.github.EzkielynaGroup/*.
Instalasi
Claude Code, satu baris per server:
claude mcp add bmkg -- npx -y mcp-bmkg
claude mcp add wilayah-indonesia -- npx -y mcp-wilayah-indonesia
claude mcp add hari-libur -- npx -y mcp-hari-libur-indonesia
claude mcp add rupiah -- npx -y mcp-rupiah
claude mcp add qris -- npx -y mcp-qrisClaude Desktop, Cursor, OpenCode, dan klien lain memakai konfigurasi JSON dengan "command": "npx" dan "args": ["-y", "mcp-rupiah"]. Di Windows pakai "command": "cmd" dan "args": ["/c", "npx", "-y", "mcp-rupiah"]. Contoh lengkap untuk tiap klien ada di README masing-masing repo.
Contoh pemakaian
BMKG + wilayah, berpasangan:
"Besok siang cuaca di Kemayoran gimana? Tadi ada gempa kuat nggak?"
- Asisten memanggil
cari_wilayahdarimcp-wilayah-indonesiauntuk menemukan kodeadm4kelurahan Kemayoran (31.71.03.1001). - Lalu memanggil
prakiraan_cuacadangempa_terbarudarimcp-bmkg. - Setiap jawaban diakhiri "Sumber: BMKG" beserta waktu WIB, karena ketentuan data terbuka BMKG mewajibkan pencantuman sumber.
- Respons di-cache 60 detik. BMKG menetapkan batas 60 permintaan per menit per IP.
Hari kerja untuk SLA:
"Kalau pesanan masuk 17 Maret 2026 dan SLA-nya 3 hari kerja, kapan paling lambat dikirim?"
Jawaban dari README server ini: 27 Maret 2026, karena Nyepi dan libur Lebaran dilewati.
Data libur 2025, 2026, dan 2027 diambil dari SKB 3 Menteri, termasuk perubahan 18 Agustus 2025. Tanggal Idulfitri 2027 masih menunggu sidang isbat.
Kuitansi dan PPN:
"Tuliskan terbilang Rp1.500.250 untuk kuitansi, dan berapa PPN dari total Rp5.550.000?"
mcp-rupiahmemakai aritmetika BigInt, jadi angka besar tidak "melenceng" seperti bilangan pecahan biasa.- Hitung PPN secara default memakai aturan PMK 131/2024 untuk barang non-mewah: 12% × 11/12, efektif 11%.
- Ini alat bantu hitung, bukan nasihat pajak.
QRIS:
"Cek QRIS ini valid nggak, lalu isi nominal Rp15.000."
validate_qrismemeriksa struktur TLV dan CRC-16.set_qris_amountmengubah QRIS statis menjadi dinamis dengan nominal tertentu, lalu menghitung ulang CRC-nya.- Untuk mencegah penyalahgunaan, server menolak input yang tidak valid atau yang sudah dinamis.
- Semua contoh di test memakai merchant fiktif.
Kenapa tanpa dependency?
- Cepat dipasang.
npx -yhanya mengunduh 4 file (wilayah 6 file karena membawa datanya). - Mudah diaudit. Server MCP berjalan dengan izin Anda, di dekat file dan key Anda. Satu file 500–1.000 baris masih bisa dibaca orang. Folder
node_modulestidak. - Diuji tanpa internet. Setiap repo punya test
node --testdengan server tiruan lokal: BMKG 13 test, wilayah 11, libur 13, Rupiah 18, QRIS 19. Test juga dijalankan di CI untuk Node 18, 20, dan 22.
Sumber data dan lisensi
- Wilayah: 91.599 baris (38 provinsi, 416 kabupaten, 98 kota, 7.285 kecamatan, 8.496 kelurahan, 75.266 desa), berdasarkan Kepmendagri 300.2.2-2430/2025. Diambil dari dataset open source
cahyadsn/wilayah(MIT), dan lisensinya ikut dikemas. - Libur: dihimpun dari halaman Setneg dan Kemenko PMK, belum dibandingkan dengan PDF yang ditandatangani. README menyebut ini terus terang.
- BMKG: data diambil langsung saat dipakai dan selalu diberi atribusi.
- QRIS: struktur mengikuti spesifikasi EMVCo MPM. Label khusus QRIS diambil dari dokumentasi publik, karena spesifikasi teknis ASPI tidak terbuka untuk umum.
Kalau Anda menemukan data yang salah, misalnya kode desa baru atau perubahan cuti bersama, buka issue di repo. Koreksi seperti itu paling berharga.
Tautan
- Organisasi GitHub: https://github.com/EzkielynaGroup
- Daftar MCP yang berguna di Indonesia (dari tim lain juga): https://github.com/EzkielynaGroup/awesome-mcp-indonesia
Ezkielyna adalah AI gateway independen: satu API key format OpenAI dan Anthropic untuk banyak model AI, isi saldo lewat QRIS, USDT atau Binance Pay tanpa kartu kredit. Ezkielyna tidak berafiliasi dengan perusahaan pembuat model.