mcp-gempa-bmkg

Contoh MCP server sederhana dengan Python. Server ini mengambil info gempa dari data terbuka BMKG, lalu bisa dipakai di Claude Desktop dan Antigravity.

Repo ini pendamping video "Bikin MCP Server Sendiri dari Nol" di kanal Tips Unix.

⚠️ Hanya untuk belajar, bukan sistem peringatan dini resmi. Untuk info gempa dan tsunami resmi, pakai kanal resmi BMKG, misalnya aplikasi InfoBMKG atau https://www.bmkg.go.id.

Isi server

Semuanya ada di satu file, server.py, dan memakai SDK resmi mcp versi 2 (MCPServer).

Related MCP server: TMD Earthquake MCP Server

Syarat

• Python 3.11 atau lebih baru

• uv

• Node.js, hanya untuk MCP Inspector (mcp dev)

Install

git clone https://github.com/<akun-kamu>/mcp-gempa-bmkg.git
cd mcp-gempa-bmkg
uv sync

Kalau mau membangun dari nol seperti di video:

uv init mcp-gempa-bmkg
cd mcp-gempa-bmkg
uv add "mcp[cli]" httpx

Lalu buat server.py. httpx harus ditambahkan sendiri karena tidak ikut terpasang bersama mcp versi 2.

Catatan: uv init versi baru juga membuat folder src/. Folder itu tidak dipakai di proyek ini dan boleh dihapus.

Uji dengan MCP Inspector

uv run mcp dev server.py

Inspector terbuka di browser. Klik Connect, lalu coba tab Tools, Resources, dan Prompts.

Sambungkan ke aplikasi AI

Ketiga aplikasi memakai entri yang sama. Ganti /PATH/LENGKAP/mcp-gempa-bmkg dengan path lengkap folder proyek. Di Windows, tulis path dengan \\, misalnya C:\\Users\\kamu\\mcp-gempa-bmkg.

{
  "mcpServers": {
    "gempa-bmkg": {
      "command": "uv",
      "args": ["--directory", "/PATH/LENGKAP/mcp-gempa-bmkg", "run", "server.py"]
    }
  }
}

Claude Desktop

Buka Settings → Developer → Edit Config. File config ada di:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

Tambahkan entri di atas, simpan, lalu keluar penuh dari Claude Desktop dan buka lagi.

Antigravity CLI (agy) dan aplikasi Antigravity

Keduanya memakai file config global yang sama: ~/.gemini/config/mcp_config.json.

• Dari aplikasi Antigravity: menu … di panel agent → MCP Servers → Manage MCP Servers → View raw config.

• Dari Antigravity CLI: edit file di atas, jalankan ulang agy, lalu ketik /mcp untuk melihat status server.

Gemini CLI

Gemini CLI tidak lagi melayani akun Google gratis sejak 18 Juni 2026 (penggantinya Antigravity CLI). Kalau kamu masih memakainya dengan API key atau lisensi enterprise, tambahkan entri yang sama di ~/.gemini/settings.json.

3 kesalahan paling umum

1. Memakai print(). Lewat stdio, stdout khusus untuk pesan JSON-RPC, jadi print() biasa bisa memutus koneksi. Pakai logging, yang menulis ke stderr, atau print(..., file=sys.stderr).

2. Path relatif di config. Aplikasi AI tidak tahu folder proyekmu. Tulis path lengkap ke folder proyek. Kalau uv tidak ditemukan, tulis juga path lengkap ke uv (cek dengan which uv di macOS/Linux atau where uv di Windows).

3. Lupa restart. Setelah config diubah, keluar penuh dari aplikasinya (bukan sekadar menutup jendela), lalu buka lagi.

Sumber data

Data gempa: BMKG (Badan Meteorologi, Klimatologi, dan Geofisika), https://data.bmkg.go.id. Sesuai ketentuan BMKG, cantumkan BMKG sebagai sumber data dan tampilkan di aplikasi atau sistemmu.

Lisensi

MIT "# MCP-SERVER"