hko_mcp

mcp-hko（香港天文台 MCP 服务）

此 MCP 服务提供对香港天文台天气数据 API 的访问。 它实现了各种工具，使客户端能够通过模型上下文协议获取天气预报、地震信息、潮汐数据及其他气象信息。

可用的天气数据工具

• 9 天天气预报（fnd）
• 当前天气报告（rhrread）
• 本地天气预报（flw）
• 天气警告信息（warningInfo）
• 天气警告摘要（warnsum）
• 特别天气提示（swt）
• 快速地震消息（qem）
• 本地有感地震报告（feltearthquake）
• 潮汐信息（HHOT, HLT）
• 天文数据（SRS, lunardate）
• 闪电和能见度数据（LHL, LTMV）
• 温度记录（CLMTEMP, CLMMAXT, CLMMINT）
• 辐射水平报告（RYES）
• 降雨数据（hourlyrainfall）

使用示例

获取 9 天天气预报

提示词：

下周三的天气怎么样？

获取当前天气报告

提示词：

现在的天气怎么样？

开发环境设置

1. 安装依赖项：

npm install

2. 启动 MCP 开发服务器：

npm run inspect

3. 构建 MCP 服务：

npm run build

4. 运行测试：

npm test

5. 以监视模式运行测试：

npm run test:watch

已为所有 API 函数编写全面的测试。详情请参阅 docs/TESTING.md。

配置（Claude Desktop）

{
  "mcpServers": {
    "mcp-hko": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:louiscklaw/mcp-hko"
      ]
    }
  }
}

配置（docker）

{
  "mcpServers": {
    "mcp-hko-docker": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp-hko:latest"],
      "name": "mcp-hko (Docker)",
    }
  }
}

项目结构

• src/ - 服务源代码
• src/lib/ - API 实现模块
• documentation/ - API 文档和测试用例
• scripts/ - 开发实用程序
• src/tests/ - 测试文件

服务架构

此 MCP 服务基于 FastMCP 框架构建，并实现了与香港天文台 API 对应的各种工具。 架构通过两张图表展示，以便于阅读：

服务概览

工具结构详情

REQ01xx：天气预报和警告

flowchart TD
    subgraph REQ01xx[Weather Forecasts & Warnings]
        direction BT
        B1[9-day Forecast]
        B2[Current Weather]
        B3[Local Forecast]
        B4[Warning Info]
        B5[Warning Summary]
        B6[Special Weather Tips]
    end

REQ02xx：地震信息

flowchart TD
    subgraph REQ02xx[Earthquake Information]
        C1[Quick Earthquake]
        C2[Felt Earthquake]
    end

REQ03xx：潮汐、天文和气候

flowchart TD
    subgraph REQ03xx[Tides, Astronomy & Climate]
        D1[Tide: HHOT]
        D2[Tide: HLT]
        D3[Sunrise/Sunset: SRS]
        D4[Lightning: LHL]
        D5[Visibility: LTMV]
        D6[Temperature: CLMTEMP]
        D7[Max Temperature: CLMMAXT]
        D8[Min Temperature: CLMMINT]
        D9[Radiation: RYES]
    end

REQ04xx：农历

flowchart TD
    subgraph REQ04xx[Lunar Calendar]
        E1[Lunar Date]
    end

REQ05xx：降雨

flowchart TD
    subgraph REQ05xx[Rainfall]
        F1[Hourly Rainfall]
    end

致谢：

• mcp-hk-transport-eta