安裝
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 必須指向你本機建置產物。不要使用未建置的原始碼路徑,也不要編造未點名的內地工具名。