Skip to main content
Glama

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

  1. Clone repository

git clone https://github.com/revomkg/bmkg-mcp.git
cd bmkg-mcp
  1. Install dependencies

Menggunakan uv (disarankan):

uv sync

Atau menggunakan pip:

pip install httpx xmltodict mcp
  1. Pastikan 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.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.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 dicari

  • admin_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 > Sumpiuh

5. 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, Banyumas

7. 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 alerts

  • language (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 kecamatan

  • language (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:

  1. Memanggil search_location_code("Pandak", "village")

  2. Menemukan kode: 33.02.07.2005

  3. Memanggil get_weather_forecast("33.02.07.2005")

  4. Menampilkan prakiraan 3 hari lengkap

Cek Gempa Terkini

User: "Ada gempa apa hari ini?"

Claude akan:

  1. Memanggil get_latest_earthquake()

  2. Menampilkan info gempa terkini + shakemap

  3. Bisa memanggil get_significant_earthquakes() untuk daftar lengkap

Cek Peringatan Cuaca di Daerah Saya

User: "Ada peringatan cuaca untuk Jagakarsa?"

Claude akan:

  1. Memanggil search_weather_alerts_by_kecamatan("Jagakarsa")

  2. Menampilkan peringatan aktif (jika ada)

  3. 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:

  1. Fork repository ini

  2. Buat branch baru (git checkout -b feature/fitur-baru)

  3. Commit perubahan (git commit -am 'Tambah fitur baru')

  4. Push ke branch (git push origin feature/fitur-baru)

  5. 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 tools
get_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

    A4.3/5.0

    Scored across 9 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 PyPI
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP 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.
      5
      MIT