DragonMCP : interroger les données publiques météo, MTR et frontière de Hong Kong

Pour qui

Si vous voulez qu’un agent interroge des données publiques en direct autour de Hong Kong et de la frontière continentale, plutôt que de brancher vous-même plusieurs API ouvertes, ce service correspond. Le texte officiel le décrit comme un serveur MCP pour agents fournissant des données publiques vérifiables.

Il convient à qui a déjà Node.js 18 ou plus récent et peut cloner le dépôt en local, puis lancer un processus stdio avec node. Les outils Hong Kong n’ont pas besoin de .env. Pour les outils Amap/Gaode, le texte officiel demande de copier le modèle puis de remplir un secret ; ne prenez pas ce chemin au premier essai. Commencez par les outils Hong Kong sans secret.

Ce n’est pas une archive hors ligne : chaque outil appelle une API en ligne, sans mock. Si un amont est indisponible, l’outil le dit directement ; il n’invente pas une réponse plausible.

Réussir le premier essai en 3 minutes

Le chemin officiel recommandé est de cloner en local et de construire. Prérequis : Node.js 18 ou plus récent sur cette machine. Les requêtes météo Hong Kong n’ont pas besoin de variables d’environnement.

Suivez les étapes officielles :

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

Après la construction, dans le client MCP mettez command à node et args vers dist/stdio.js dans le clone local. Les exemples officiels utilisent un chemin absolu de substitution ; remplacez-le par le vrai chemin après votre clone. Ne copiez pas le répertoire de substitution. Enregistrez, rechargez le client, confirmez que le service est connecté.

Puis une requête en lecture seule : appelez hk_weather_current. Le tableau officiel dit qu’il parle à l’observatoire de Hong Kong, pour la météo actuelle et les alertes en vigueur. Le tableau n’écrit pas les champs de paramètres ; appelez selon la définition d’outil affichée par le client. N’inventez pas un numéro de station ni un paramètre absent.

Signal de succès : météo actuelle et alertes en vigueur reviennent. Si un amont est indisponible, l’outil l’explique au lieu d’inventer la météo. Vous pouvez aussi appeler system_run_selftest, qui sonde chaque amont et indique lesquels sont joignables maintenant ; c’est le chemin de vérification officiel, pas une étape obligatoire du premier essai.

Cas d’usage

Cas 1 : météo actuelle et alertes de Hong Kong. Appelez hk_weather_current. Le texte officiel dit qu’il parle à l’observatoire de Hong Kong et renvoie Current conditions + active warnings. Aucune table de champs ni station d’exemple ; en cas de succès vous devez voir les conditions actuelles et les alertes en vigueur, et les traiter comme un résultat d’API en direct, pas un cache hors ligne.

Cas 2 : trajets et arrivées MTR. Appelez search_mtr_schedule. Le texte officiel dit que les données viennent de data.gov.hk, pour la planification de correspondances et les arrivées en direct, couvrant les 10 lignes, 98 stations. Il n’écrit pas comment passer origine et destination ; n’utilisez que les champs affichés par le client. En cas de succès vous devez voir un trajet ou des arrivées. Ne le lisez pas comme un moyen de changer l’horaire.

La même page nomme aussi hk_typhoon_signal, pour l’état structuré des alertes typhon, pluie torrentielle et autres alertes en vigueur, également vers l’observatoire de Hong Kong. Inutile de l’appeler au premier essai.

Limites

Le prérequis est Node.js 18+. Les outils Hong Kong n’ont pas besoin de .env ; les outils Amap/Gaode exigent un secret selon le modèle officiel. Cette page n’écrit pas le nom de variable du secret ; ne le devinez pas au premier essai. Chaque outil frappe une API en ligne, sort sur le réseau, et peut exposer la ligne ou le thème météo interrogé.

Le texte officiel n’indique ni limite de débit, ni quota, ni durée de cache. Si un amont est en panne, l’outil le dit ; system_run_selftest peut sonder la joignabilité. Aucune annulation ni rollback. Ces requêtes sont des données publiques en lecture seule, mais pas un risque zéro.

dist/stdio.js dans la configuration doit pointer vers l’artefact construit sur cette machine. N’utilisez pas un chemin source non construit, et n’inventez pas de noms d’outils continentaux non cités.