DragonMCP：香港の天気、MTR、国境の公共データを調べる

向いている人

エージェントに香港と中国大陸との国境一帯のリアルタイム公共データを調べさせたい、自分で複数の公開 API を接続したくないなら、このサービスが合います。公式はエージェント向け MCP サーバーと書き、検証可能な公共データを提供します。

Node.js 18 以上が既に入り、リポジトリをローカルにクローンしたあと node で stdio プロセスを走らせられる人向けです。香港ツールに .env は不要です。Amap 関連ツールを使うなら、公式はテンプレートをコピーしてからシークレットを埋めるよう求めています。初回試行ではその経路を使わず、シークレット不要の香港ツールから始めてください。

オフラインのデータベースではありません。各ツールはオンライン API を呼び、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 に向けます。公式例は絶対パスのプレースホルダです。クローン後の実パスに替え、プレースホルダディレクトリを丸写ししないでください。保存してクライアントを再読み込みし、サービスが接続済みか確認します。

その後、読み取り専用の照会を1回：hk_weather_current を呼び出します。公式表は香港天文台に接続し、現在の天気と有効中の警報向けだと明記しています。表はパラメータ欄を書いていません。クライアントが表示するツール定義どおりに呼び出してください。駅番号や出ていないパラメータを自分で捏造しないでください。

成功の合図：現在の天気と有効警報が返ること。上流が使えないときは天気を捏造せず、ツールが説明します。system_run_selftest を呼ぶこともでき、各上流を疎通確認して今どれが到達可能かを報告します。これは公式の検証方法であり、初回必須ではありません。

使用例

例 1：香港の現在天気と警報を調べる。hk_weather_current を呼び出します。公式は香港天文台に接続し、Current conditions + active warnings を返すと明記しています。フィールド表もサンプル駅もありません。成功時は現在状況と有効警報が見え、オフラインキャッシュではなくリアルタイム API 結果として扱ってください。

例 2：MTR の行程と到着照会。search_mtr_schedule を呼び出します。公式はデータが data.gov.hk 由来で、乗換行程計画とリアルタイム到着向け、全 10 路線、98 駅を覆うと明記しています。公式は起点と終点の渡し方を書いていません。クライアントが表示するフィールドだけを使ってください。成功時は行程または到着情報が見えるはずです。時刻表を変えられるとは読まないでください。

同じページは hk_typhoon_signal も名指しし、台風、大雨、その他の有効警報の構造化状態向けで、同じく香港天文台に接続します。初回に呼ぶ必要はありません。

使用上の境界

前提は Node.js 18+ です。香港ツールに .env は不要です。Amap ツールは公式テンプレートどおりシークレットを埋める必要があり、本ページはシークレット変数名を書いていません。初回に推測しないでください。各ツールはオンライン API を打ち、外部通信し、照会した路線や天気テーマも露呈し得ます。

公式はレート制限、割当、キャッシュ寿命を書いていません。上流が落ちるとツールが説明します。system_run_selftest で各上流が到達可能かを疎通確認できます。公式は取り消しやロールバックを出していません。これらの照会は読み取り専用の公共データですが、ゼロリスクではありません。

設定の dist/stdio.js は、このマシンのビルド成果物を指す必要があります。未ビルドのソースパスを使わず、名指しされていない中国大陸向けツール名も捏造しないでください。