BMKG MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BMKG MCP Server what's the weather forecast for Bandung for the next 3 days?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BMKG MCP Server (Unofficial)
Server MCP (Model Context Protocol) untuk mengakses data dari BMKG (Badan Meteorologi, Klimatologi, dan Geofisika Indonesia). Server ini menyediakan akses mudah ke data gempa bumi, prakiraan cuaca, dan peringatan dini cuaca untuk seluruh wilayah Indonesia.
β¨ Fitur
π Data Gempa Bumi
Gempa Terkini: Info gempa bumi terbaru dengan shakemap
15 Gempa M 5.0+: Daftar gempa berkekuatan 5.0 atau lebih
15 Gempa Dirasakan: Daftar gempa yang dirasakan masyarakat
βοΈ Prakiraan Cuaca
Prakiraan 3 Hari: Data lengkap hingga level kelurahan/desa
Update Per 3 Jam: 8 forecast per hari (total Β±24 forecast)
Data Lengkap: Suhu, kelembaban, angin, tutupan awan, jarak pandang
β οΈ Peringatan Dini Cuaca
Nowcast: Peringatan cuaca ekstrem aktif di seluruh Indonesia
Berbasis CAP: Mengikuti standar Common Alerting Protocol
Level Kecamatan: Detail wilayah terdampak hingga kecamatan
Bilingual: Tersedia dalam Bahasa Indonesia dan English
πΊοΈ Pencarian Kode Wilayah
Database Lokal: 91,220+ wilayah dari provinsi hingga desa
Pencarian Fleksibel: Cari berdasarkan nama di semua level
Hierarki Lengkap: Tampilan struktur provinsi > kabupaten > kecamatan > desa
Related MCP server: wems-mcp-server
π¦ Instalasi
Prasyarat
Python 3.8 atau lebih baru
uv (package manager) atau pip
Langkah Instalasi
Clone repository
git clone https://github.com/revomkg/bmkg-mcp.git
cd bmkg-mcpInstall dependencies
Menggunakan uv (disarankan):
uv syncAtau menggunakan pip:
pip install httpx xmltodict mcpPastikan file base.csv ada
File base.csv berisi database kode wilayah Indonesia. Pastikan file ini ada di direktori yang sama dengan bmkg-server.py.
π Penggunaan
Konfigurasi di Claude Desktop
Tambahkan konfigurasi berikut ke file claude_desktop_config.json:
Lokasi file konfigurasi:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Isi konfigurasi:
{
"mcpServers": {
"bmkg": {
"command": "python",
"args": ["/path/to/bmkg-mcp/bmkg-server.py"]
}
}
}Atau dengan uv:
{
"mcpServers": {
"bmkg": {
"command": "uv",
"args": ["run", "/path/to/bmkg-mcp/bmkg-server.py"]
}
}
}π§ Tools yang Tersedia
1. get_latest_earthquake()
Mendapatkan informasi gempa bumi terkini dengan shakemap.
Return:
Waktu kejadian
Magnitudo
Kedalaman
Lokasi
Potensi tsunami
URL shakemap
2. get_significant_earthquakes()
Daftar 15 gempa bumi terkini dengan magnitudo 5.0+.
Return:
Array of earthquakes dengan detail lengkap
Potensi tsunami untuk setiap gempa
3. get_felt_earthquakes()
Daftar 15 gempa bumi yang dirasakan masyarakat.
Return:
Array of earthquakes
Info daerah yang merasakan
4. search_location_code(location_name, admin_level)
Mencari kode wilayah berdasarkan nama lokasi.
Parameters:
location_name(string): Nama lokasi yang dicariadmin_level(string, optional): Filter level administratif"all"- Semua level (default)"province"/"provinsi"- Provinsi"regency"/"kabkota"- Kabupaten/Kota"district"/"kecamatan"- Kecamatan"village"/"desa"- Kelurahan/Desa
Contoh:
search_location_code("Pandak", "village")
# Returns: 33.02.07.2005 - Pandak di Jawa Tengah > Banyumas > Sumpiuh5. get_villages_in_district(district_code)
Mendapatkan semua kelurahan/desa dalam kecamatan tertentu.
Parameters:
district_code(string): Kode kecamatan (contoh: "33.02.07")
Return:
Daftar lengkap kelurahan/desa dengan kode siap pakai
6. get_weather_forecast(kode_wilayah)
Prakiraan cuaca 3 hari untuk wilayah tertentu.
Parameters:
kode_wilayah(string): Kode wilayah level desa (4 segmen)
Return:
Prakiraan 3 hari dengan 8 forecast per hari
Suhu, kelembaban, cuaca, angin, tutupan awan, jarak pandang
Total Β±24 forecast points
Contoh:
get_weather_forecast("33.02.07.2005") # Pandak, Sumpiuh, Banyumas7. get_weather_alerts(language)
Daftar peringatan dini cuaca aktif di Indonesia.
Parameters:
language(string, optional): "id" atau "en" (default: "id")
Return:
RSS feed peringatan cuaca aktif
Link ke detail CAP tiap provinsi
8. get_weather_alert_detail(cap_code, language)
Detail peringatan dini cuaca untuk provinsi tertentu.
Parameters:
cap_code(string): Kode CAP dari link di weather alertslanguage(string, optional): "id" atau "en" (default: "id")
Return:
Detail lengkap CAP
Wilayah kecamatan terdampak
Waktu berlaku dan berakhir
Tingkat bahaya (severity, urgency, certainty)
9. search_weather_alerts_by_kecamatan(kecamatan, language)
Mencari peringatan dini untuk kecamatan tertentu.
Parameters:
kecamatan(string): Nama kecamatanlanguage(string, optional): "id" atau "en" (default: "id")
Return:
Peringatan yang mempengaruhi kecamatan tersebut
Detail wilayah terdampak
π‘ Contoh Penggunaan
Mencari Cuaca untuk Lokasi Tertentu
User: "Bagaimana cuaca di Pandak, Sumpiuh?"
Claude akan:
Memanggil
search_location_code("Pandak", "village")Menemukan kode:
33.02.07.2005Memanggil
get_weather_forecast("33.02.07.2005")Menampilkan prakiraan 3 hari lengkap
Cek Gempa Terkini
User: "Ada gempa apa hari ini?"
Claude akan:
Memanggil
get_latest_earthquake()Menampilkan info gempa terkini + shakemap
Bisa memanggil
get_significant_earthquakes()untuk daftar lengkap
Cek Peringatan Cuaca di Daerah Saya
User: "Ada peringatan cuaca untuk Jagakarsa?"
Claude akan:
Memanggil
search_weather_alerts_by_kecamatan("Jagakarsa")Menampilkan peringatan aktif (jika ada)
Detail tingkat bahaya dan waktu berlaku
π Sumber Data
Data yang digunakan server ini berasal dari:
BMKG (data.bmkg.go.id): Data gempa bumi dan cuaca resmi
BMKG API (api.bmkg.go.id): API prakiraan cuaca dan peringatan dini
Kode Wilayah: Database lokal berdasarkan Keputusan Mendagri No. 100.1.1-6117 Tahun 2022
π Batasan Akses
Sesuai dokumentasi BMKG:
Prakiraan Cuaca: 60 permintaan per menit per IP
Peringatan Dini: 60 permintaan per menit per IP
Gunakan dengan bijak untuk menghindari rate limiting.
π€ Kontribusi
Kontribusi selalu diterima! Silakan:
Fork repository ini
Buat branch baru (
git checkout -b feature/fitur-baru)Commit perubahan (
git commit -am 'Tambah fitur baru')Push ke branch (
git push origin feature/fitur-baru)Buat Pull Request
π Lisensi
Proyek ini dilisensikan di bawah MIT License.
Proyek ini adalah unofficial dan tidak berafiliasi dengan BMKG. Data yang digunakan berasal dari sumber publik BMKG.
β οΈ Disclaimer
Server ini dibuat untuk memudahkan akses data BMKG melalui Model Context Protocol. Pengguna bertanggung jawab untuk mematuhi syarat dan ketentuan penggunaan data dari BMKG.
π Credits
Data gempa dan cuaca dari BMKG
Database kode wilayah berdasarkan Keputusan Mendagri
Menggunakan FastMCP untuk MCP server
π§ Kontak
Untuk pertanyaan, saran, atau laporan bug, silakan buat issue di repository ini.
β Jika proyek ini bermanfaat, berikan bintang di GitHub!
Available Tools
9 toolsget_felt_earthquakesA
Mengambil daftar 15 gempabumi terkini yang dirasakan masyarakat.
Mengembalikan detail waktu, lokasi, magnitudo, kedalaman, dan daerah yang merasakan.
Sumber Data: BMKG (Badan Meteorologi, Klimatologi, dan Geofisika)
Inputs: no named parameters. Returns: result
get_latest_earthquakeA
Mengambil data gempa bumi terbaru yang dirasakan (M 5.0+ atau signifikan).
Mengembalikan detail waktu, lokasi, magnitudo, dan potensi tsunami.
Sumber Data: BMKG (Badan Meteorologi, Klimatologi, dan Geofisika)
Inputs: no named parameters. Returns: result
get_significant_earthquakesA
Mengambil daftar 15 gempabumi terkini dengan magnitudo 5.0 atau lebih.
Mengembalikan detail waktu, lokasi, magnitudo, kedalaman, dan potensi tsunami.
Sumber Data: BMKG (Badan Meteorologi, Klimatologi, dan Geofisika)
Inputs: no named parameters. Returns: result
get_villages_in_districtA
Mendapatkan daftar semua kelurahan/desa dalam kecamatan tertentu dari database lokal.
Args:
district_code: Kode kecamatan (contoh: "33.02.07" untuk Sumpiuh)
Returns:
Daftar kelurahan/desa dengan kode lengkap yang siap digunakan untuk prakiraan cuaca.
Inputs: district_code (required). Returns: result
get_weather_alert_detailA
Mengambil detail peringatan dini cuaca untuk provinsi tertentu berdasarkan CAP code.
Mengembalikan informasi detail wilayah kecamatan terdampak.
Args:
cap_code: Kode detail CAP (contoh: "20231125120000_BMKG001")
language: Bahasa output, "id" untuk Indonesia atau "en" untuk English (default: "id")
Returns:
Detail CAP meliputi: event, effective, expires, senderName, headline,
description, web (infografik), dan area polygon wilayah terdampak.
Inputs: cap_code (required), language. Returns: result
get_weather_alertsA
Mengambil peringatan dini cuaca ekstrem (hujan lebat/petir) yang sedang aktif di Indonesia.
Data berbasis Common Alerting Protocol (CAP) hingga level kecamatan.
Args:
language: Bahasa output, "id" untuk Indonesia atau "en" untuk English (default: "id")
Returns:
Daftar peringatan dini cuaca aktif dengan informasi provinsi terdampak,
waktu publikasi, deskripsi wilayah, dan tautan detail CAP.
Inputs: language. Returns: result
get_weather_forecastA
Mengambil prakiraan cuaca berdasarkan kode wilayah (adm4).
Args:
kode_wilayah: Kode wilayah Indonesia level desa/kelurahan (adm4).
Default: 31.71.01.1001 (Gambir, Jakarta Pusat).
Returns:
Prakiraan cuaca 3 hari dengan interval 3 jam (Β±24 forecast total).
Termasuk: suhu, kelembaban, kondisi cuaca, angin, tutupan awan, jarak pandang.
Sumber Data: BMKG (Badan Meteorologi, Klimatologi, dan Geofisika)
Note:
Untuk mencari kode wilayah, gunakan search_location_code() terlebih dahulu
Format kode: [kode_provinsi].[kode_kabkota].[kode_kecamatan].[kode_desa]
Contoh: 31.71.01.1001 = DKI Jakarta > Jakarta Pusat > Gambir > Gambir
Inputs: kode_wilayah. Returns: result
search_location_codeA
Mencari kode wilayah Indonesia berdasarkan nama lokasi menggunakan database lokal.
Mendukung pencarian di semua level: provinsi, kabupaten/kota, kecamatan, kelurahan/desa.
Args:
location_name: Nama lokasi yang dicari (contoh: "Pandak", "Sumpiuh", "Banyumas")
admin_level: Level administratif yang dicari:
- "province" atau "provinsi" untuk provinsi
- "regency" atau "kabkota" untuk kabupaten/kota
- "district" atau "kecamatan" untuk kecamatan
- "village" atau "desa" untuk kelurahan/desa
- "all" untuk mencari di semua level (default)
Returns:
Daftar kode wilayah yang cocok dengan pencarian, dengan hierarki lengkap.
Note:
Kode level desa (4 segmen) dapat langsung digunakan untuk get_weather_forecast()
Inputs: location_name (required), admin_level. Returns: result
search_weather_alerts_by_kecamatanA
Mencari peringatan dini cuaca yang aktif untuk kecamatan tertentu.
Tool ini akan mencari di seluruh peringatan aktif dan mengembalikan yang relevan dengan kecamatan.
Args:
kecamatan: Nama kecamatan yang ingin dicari (contoh: "Kebayoran Baru", "Bogor Barat")
language: Bahasa output, "id" untuk Indonesia atau "en" untuk English (default: "id")
Returns:
Daftar peringatan dini cuaca yang mempengaruhi kecamatan tersebut,
termasuk detail waktu berlaku, jenis kejadian, dan wilayah terdampak.
Inputs: kecamatan (required), language. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 9 tools
Most tools have distinct purposes, but there is some overlap between earthquake-related tools. get_felt_earthquakes, get_latest_earthquake, and get_significant_earthquakes all retrieve earthquake data with subtle differences in criteria (felt vs. latest vs. magnitude β₯5.0), which could cause confusion for an agent. The weather and location tools are clearly distinct.
All tool names follow a consistent snake_case pattern with a clear verb_noun structure (e.g., get_weather_forecast, search_location_code). The naming is uniform across all tools, making them predictable and easy to understand.
With 9 tools, the count is well-scoped for a BMKG (meteorology and geophysics) server. It covers earthquakes, weather forecasts, alerts, and location searches without being overwhelming, allowing for comprehensive functionality in a manageable set.
The tool set provides good coverage for BMKG data, including earthquakes, weather forecasts, and alerts with search capabilities. A minor gap is the lack of tools for historical data or more granular weather parameters, but core workflows are supported with tools like get_weather_forecast and search_location_code working together.
Maintenance
Related MCP Connectors
This MCP server provides seamless access to Malaysia's government open data, including datasets, wβ¦
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
Official IPinfo MCP Server - IP intelligence tools for AI assistants
An MCP server for weather information by @kulybaba
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides real-time weather data, hourly forecasts, and daily summaries using the free Open-Meteo API with no API key required. It enables users to search for weather conditions by specific coordinates or city names across multiple measurement units.2MIT
- AlicenseNot gradedqualityDmaintenanceA powerful MCP server that connects AI assistants to authoritative natural hazard data sources, enabling monitoring of earthquakes, tsunamis, volcanoes, and solar events with configurable alerts and webhooks.80 PyPI1MIT
- AlicenseAqualityCmaintenanceMCP server wrapping the USGS Earthquake Hazards API, enabling AI assistants to search the global earthquake catalog, look up event details, count quakes, find 'Did You Feel It' reports, and read realtime feeds.5MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server providing AI-powered weather tools via Google Generative AI, enabling real-time weather data retrieval through natural language queries.MIT