Hko MCP

香港天文台mcp服务器

此MCP服务器提供香港天文台天气数据API的访问。 它实现了各种工具，允许客户端通过模型上下文协议检索天气预报、地震信息、潮汐数据和其他气象信息。

可用的天气数据工具

• 九天天气预报(发现)
• 当前天气报告(rhrread)
• 当地天气预报(跟随)
• 天气预警信息(警告信息)
• 天气预警摘要(warnsum)
• 特殊天气提示(甜)
• 快速地震信息(qem)
• 当地感受到的地震报告(毡地震)
• 潮汐信息(HHOT，HLT)
• 天文数据(SRS，lunardate)
• 闪电和能见度数据(LHL、LTMV)
• 温度记录(CLMTEMP，CLMMAXT，CLMMINT)
• 辐射水平报告(黑麦)
• 降雨数据(小时降雨)

使用示例

获取9天天气预报

提示： 下周三的天气怎么样？

获取当前天气预报

提示： 现在天气怎么样？

开发设置

1. 安装依赖项：

npm install

1. 启动MCP开发服务器：

npm run inspect

1. 构建MCP服务器：

npm run build

1. 运行测试：

npm test

1. 在监视模式下运行测试：

npm run test:watch

已经为所有API函数创建了全面的测试。看 docs/TEST.md 了解详情。

配置（克劳德桌面）

{
  "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

需求05xx：降雨

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

信用：

• mcp-hk运输eta