DragonMCP: consultar datos públicos de clima, MTR y frontera de Hong Kong

Para quién

Si quieres que un agente consulte datos públicos en vivo alrededor de Hong Kong y la frontera continental, en vez de cablear tú varias API abiertas, este servicio encaja. Lo oficial lo describe como un servidor MCP para agentes que ofrece datos públicos verificables.

Encaja con quien ya tiene Node.js 18 o más reciente y puede clonar el repositorio en local y luego ejecutar un proceso stdio con node. Las herramientas de Hong Kong no necesitan .env. Si quieres herramientas Amap/Gaode, lo oficial pide copiar la plantilla y luego rellenar un secreto; no tomes ese camino en el primer intento. Empieza con las herramientas de Hong Kong que no necesitan secreto.

No es un archivo sin conexión: cada herramienta llama a una API en línea, sin mock. Si un origen no está disponible, la herramienta lo dice directamente; no inventa una respuesta verosímil.

Completar el primer intento en 3 minutos

El camino oficial recomendado es clonar en local y construir. Requisito: Node.js 18 o más reciente en esta máquina. Las consultas de clima de Hong Kong no necesitan variables de entorno.

Sigue los pasos oficiales:

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

Tras la construcción, en el cliente MCP pon command en node y args hacia dist/stdio.js del clon local. Los ejemplos oficiales usan una ruta absoluta de relleno; cámbiala por la ruta real tras tu clon. No copies el directorio de relleno. Guarda, recarga el cliente y confirma que el servicio está conectado.

Luego una consulta de solo lectura: llama hk_weather_current. La tabla oficial dice que habla con el Observatorio de Hong Kong y sirve para el clima actual y avisos vigentes. La tabla no escribe campos de parámetros; llama según la definición de herramienta que muestre el cliente. No inventes un número de estación ni un parámetro que no aparece.

Señal de éxito: devuelve el clima actual y avisos vigentes. Si un origen no está disponible, la herramienta lo explica en vez de inventar el clima. También puedes llamar system_run_selftest, que sondea cada origen e informa cuáles son alcanzables ahora; es el camino de verificación oficial, no un paso obligatorio del primer intento.

Casos de uso

Caso 1: clima actual y avisos de Hong Kong. Llama hk_weather_current. Lo oficial dice que habla con el Observatorio de Hong Kong y devuelve Current conditions + active warnings. No hay tabla de campos ni estación de ejemplo; si tiene éxito debes ver condiciones actuales y avisos vigentes, y tratarlos como resultado de API en vivo, no como caché sin conexión.

Caso 2: trayectos y llegadas MTR. Llama search_mtr_schedule. Lo oficial dice que los datos vienen de data.gov.hk, para planificar transbordos y llegadas en vivo, cubriendo las 10 líneas, 98 estaciones. No escribe cómo pasar origen y destino; usa solo los campos que muestre el cliente. Si tiene éxito debes ver información de trayecto o llegada. No lo leas como forma de cambiar el horario.

La misma página también nombra hk_typhoon_signal, para el estado estructurado de tifón, lluvia intensa y otros avisos vigentes, también con el Observatorio de Hong Kong. No hace falta llamarlo en el primer intento.

Límites

El requisito previo es Node.js 18+. Las herramientas de Hong Kong no necesitan .env; las de Amap/Gaode necesitan un secreto según la plantilla oficial. Esta página no escribe el nombre de la variable del secreto; no lo adivines en el primer intento. Cada herramienta golpea una API en línea, sale a la red y puede exponer la línea o el tema de clima que consultaste.

Lo oficial no escribe límite de velocidad, cuota ni duración de caché. Si un origen cae, la herramienta lo dice; system_run_selftest puede sondear si cada origen es alcanzable. No hay deshacer ni rollback. Estas consultas son datos públicos de solo lectura, pero no son riesgo cero.

dist/stdio.js en la configuración debe apuntar al artefacto construido en esta máquina. No uses una ruta de código fuente sin construir, ni inventes nombres de herramientas continentales no nombradas.