Hko

A Streamable HTTP MCP server for Hong Kong Observatory open data, built with Bun.

Run

bun install
bun run start

The MCP endpoint is:

http://localhost:3000/mcp

Set a custom port with:

PORT=8787 bun run start

Tools

• get_weather_information: HKO weather forecast, current report, warnings, warning details, and special weather tips.
• get_earthquake_information: quick earthquake messages and locally felt earth tremor reports.
• get_open_data: climate and weather open-data datasets such as tides, sun/moon events, lightning counts, visibility, daily temperatures, and weather/radiation reports.
• get_lunar_date: Gregorian to lunar date conversion.
• get_hourly_rainfall: past-hour rainfall from automatic weather stations.
• list_supported_datasets: dataset codes, languages, and station groups.

Example Requests

{
  "dataType": "rhrread",
  "lang": "en"
}

{
  "dataType": "LTMV",
  "rformat": "json",
  "lang": "en"
}

{
  "date": "2026-06-20"
}

The implementation follows HKO Open Data API documentation version 1.12, dated November 2024.