bmkg-mcp 1.0.0

package/README.md

@@ -0,0 +1,17 @@
+# bmkg-mcp
+
+Keyless BMKG Indonesia: village-level 3-hourly forecasts plus felt and latest earthquakes.
+
+## Setup
+
+No API key needed.
+
+Please credit BMKG as the data source in your application (required by BMKG).
+
+## Tools
+
+- `get_forecast` — 3-hourly 3-day BMKG forecast for an Indonesian village by adm4 code (e.g. 31.71.03.1001 Kemayoran, Jakarta). Codes at kodewilayah.id.
+- `get_felt_earthquakes` — Recently felt Indonesian earthquakes: magnitude, depth, location, MMI scale.
+- `get_latest_earthquakes` — Latest Indonesian earthquakes M5+: time, coordinates, magnitude, region.
+
+Part of [awesome-mcps](https://github.com/mrfentmen/awesome-mcps).

package/dist/api.d.ts

@@ -0,0 +1,7 @@
+export declare class BmkgError extends Error {
+    constructor(message: string);
+}
+export declare function errorMessage(e: unknown): string;
+export declare function getForecast(adm4: string): Promise<string>;
+export declare function getFeltEarthquakes(): Promise<string>;
+export declare function getLatestEarthquakes(): Promise<string>;

package/dist/api.js

@@ -0,0 +1,53 @@
+export class BmkgError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BmkgError";
+    }
+}
+export function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+const UA = { "User-Agent": "awesome-mcps/1.0" };
+function envStrict(name) {
+    const v = process.env[name];
+    if (!v)
+        throw new BmkgError(`Set the ${name} environment variable.`);
+    return v;
+}
+async function authHeaders() {
+    return {};
+}
+function pretty(data) {
+    const t = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+    return t.length > 12000 ? t.slice(0, 12000) + "\n…(truncated)" : t;
+}
+async function req(url, init = {}) {
+    const res = await fetch(url, { headers: { ...UA, ...(await authHeaders()), ...(init.headers ?? {}) }, ...init });
+    const ct = res.headers.get("content-type") ?? "";
+    const data = ct.includes("json") ? await res.json() : await res.text();
+    if (!res.ok) {
+        const detail = typeof data === "string" ? data.slice(0, 300) : JSON.stringify(data).slice(0, 300);
+        throw new BmkgError(`HTTP ${res.status}: ${detail}`);
+    }
+    return data;
+}
+export async function getForecast(adm4) {
+    let url = `https://api.bmkg.go.id/publik/prakiraan-cuaca`;
+    const qs = new URLSearchParams();
+    qs.append("adm4", String(adm4));
+    const qstr = qs.toString();
+    if (qstr)
+        url += (url.includes('?') ? '&' : '?') + qstr;
+    const data = await req(url);
+    return pretty(data);
+}
+export async function getFeltEarthquakes() {
+    let url = `https://data.bmkg.go.id/DataMKG/TEWS/gempadirasakan.json`;
+    const data = await req(url);
+    return pretty(data);
+}
+export async function getLatestEarthquakes() {
+    let url = `https://data.bmkg.go.id/DataMKG/TEWS/gempaterkini.json`;
+    const data = await req(url);
+    return pretty(data);
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,54 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { errorMessage, getForecast, getFeltEarthquakes, getLatestEarthquakes, } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+export function createServer() {
+    const server = new McpServer({
+        name: "bmkg-mcp",
+        version: "1.0.0",
+    });
+    server.registerTool("get_forecast", {
+        title: "Get village forecast",
+        description: "3-hourly 3-day BMKG forecast for an Indonesian village by adm4 code (e.g. 31.71.03.1001 Kemayoran, Jakarta). Codes at kodewilayah.id.",
+        inputSchema: z.object({
+            adm4: z.string().describe("Village code W.X.Y.Z"),
+        }),
+        annotations: READ_ONLY,
+    }, async ({ adm4 }) => {
+        try {
+            return text(await getForecast(adm4));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("get_felt_earthquakes", {
+        title: "Get felt earthquakes",
+        description: "Recently felt Indonesian earthquakes: magnitude, depth, location, MMI scale.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async ({}) => {
+        try {
+            return text(await getFeltEarthquakes());
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("get_latest_earthquakes", {
+        title: "Get latest earthquakes",
+        description: "Latest Indonesian earthquakes M5+: time, coordinates, magnitude, region.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async ({}) => {
+        try {
+            return text(await getLatestEarthquakes());
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "bmkg-mcp",
+  "version": "1.0.0",
+  "description": "Keyless BMKG Indonesia: village-level 3-hourly forecasts plus felt and latest earthquakes.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/bmkg-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/awesome-mcps.git"
+  },
+  "bin": {
+    "bmkg-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "rm -rf dist && tsc -p tsconfig.json && node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "bmkg",
+    "indonesia",
+    "weather",
+    "earthquake"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}