# hko-mcp

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

## Run

```bash
bun install
bun run start
```

The MCP endpoint is:

```bash
http://localhost:3000/mcp
```

Set a custom port with:

```bash
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

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

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

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

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