MCP

DragonMCP:查香港天气、港铁和边境公共数据

适合要让智能体查香港天气、台风警告和港铁实时到站的人,前提是本机已安装 Node.js 18 或更新版本,并先走无需密钥的香港工具。

官方来源 · DragonMCP

安装

git clone https://github.com/arthurpanhku/DragonMCP.git
cd DragonMCP
npm install
npm run build

适合谁

如果你要让智能体查香港和内地边境一带的实时公共数据,而不是自己对接多个开放接口,这个服务对得上。官方把它写成给智能体用的 MCP 服务器,提供可核验的公共数据。

适合已经安装 Node.js 18 或更新版本、并能在本地克隆仓库后用 node 跑 stdio 进程的人。香港工具不需要 .env。如果你要使用高德相关工具,官方要求先复制模板再补密钥;第一次尝试不要走这条,先用无需密钥的香港工具。

它不是离线资料库:每个工具都会调用线上接口,没有 mock。上游不可用时工具会直接说明,不会编造看起来合理的答案。

3 分钟完成第一次尝试

官方推荐路径是本地克隆并构建。前置条件:本机 Node.js 18 或更新版本。香港天气查询不需要环境变量。

按官方步骤执行:

git clone https://github.com/arthurpanhku/DragonMCP.git
cd DragonMCP
npm install
npm run build

构建完成后,在 MCP 客户端里把 command 设为 node,args 指向本机仓库里的 dist/stdio.js。官方示例用绝对路径占位,这里改成你克隆后的真实路径,不要照抄占位目录。保存并重载客户端,确认服务已连接。

然后做一次只读查询:调用 hk_weather_current。官方表格写明它对接香港天文台,用途是当前天气和生效中的警告。表格没有写出参数字段;按客户端展示的工具定义调用即可,不要自行发明站点编号或未出现的参数。

成功信号:返回当前天气和生效警告。若上游不可用,工具会说明,而不是编造天气。也可以再调用 system_run_selftest,它会探测各上游并报告当前哪些可达;这是官方给出的核验方式,不是第一次必做项。

使用案例

案例一:查香港当前天气和警告。调用 hk_weather_current。官方写明对接香港天文台,返回 Current conditions + active warnings。没有给出字段列表或示例站点;成功时你应看到当前状况和生效警告,并把它当成实时接口结果,而不是离线缓存。

案例二:做港铁行程与到站查询。调用 search_mtr_schedule。官方写明数据来自 data.gov.hk,用途是换乘行程规划和实时到站,覆盖全部 10 条线路、98 个车站。官方没有写出起点终点怎么传;只使用客户端列出的字段。成功时你应看到行程或到站信息。不要把它理解成可以改时刻表。

同页还点名了 hk_typhoon_signal,用于台风、暴雨和其他生效警告的结构化状态,同样对接香港天文台。第一次不必调用它。

使用边界

前置是 Node.js 18+。香港工具无需 .env;高德工具需要按官方模板补密钥,本页没有写出密钥变量名,第一次不要去猜。每个工具都打线上接口,会出网,也会暴露你查询过的线路或天气主题。

官方没有写速率限制、配额或缓存时效。上游挂了工具会说明,可用 system_run_selftest 探测各上游是否可达。官方没有给出撤销或回滚;这些查询都是只读公共数据,但不是零风险。

配置里的 dist/stdio.js 必须指向你本机构建产物。不要使用未构建的源码路径,也不要编造未点名的内地工具名。