DragonMCP: consultar dados públicos de meteorologia, MTR e fronteira de Hong Kong

Para quem

Se quer que um agente consulte dados públicos em direto em torno de Hong Kong e da fronteira continental, em vez de ligar várias API abertas, este serviço encaixa. O texto oficial descreve-o como um servidor MCP para agentes com dados públicos verificáveis.

Serve quem já tem Node.js 18 ou mais recente e consegue clonar o repositório em local e depois correr um processo stdio com node. As ferramentas de Hong Kong não precisam de .env. Se quiser ferramentas Amap/Gaode, o texto oficial pede copiar o modelo e depois preencher um segredo; não tome esse caminho na primeira tentativa. Comece pelas ferramentas de Hong Kong sem segredo.

Não é um arquivo offline: cada ferramenta chama uma API em linha, sem mock. Se um upstream estiver indisponível, a ferramenta diz-o diretamente; não inventa uma resposta plausível.

Concluir a primeira tentativa em 3 minutos

O caminho oficial recomendado é clonar em local e construir. Pré-requisito: Node.js 18 ou mais recente nesta máquina. As consultas meteorológicas de Hong Kong não precisam de variáveis de ambiente.

Siga os passos oficiais:

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

Após a construção, no cliente MCP defina command como node e args para dist/stdio.js no clone local. Os exemplos oficiais usam um caminho absoluto de substituição; substitua-o pelo caminho real após o seu clone. Não copie o diretório de substituição. Guarde, recarregue o cliente e confirme que o serviço está ligado.

Depois faça uma consulta só de leitura: chame hk_weather_current. A tabela oficial diz que fala com o Observatório de Hong Kong e serve o tempo atual e avisos ativos. A tabela não escreve campos de parâmetros; chame segundo a definição de ferramenta que o cliente mostra. Não invente um número de estação nem um parâmetro que não aparece.

Sinal de sucesso: devolve o tempo atual e avisos ativos. Se um upstream estiver indisponível, a ferramenta explica em vez de inventar o tempo. Também pode chamar system_run_selftest, que sonda cada upstream e indica quais são alcançáveis agora; é o caminho de verificação oficial, não um passo obrigatório da primeira tentativa.

Casos de uso

Caso 1: tempo atual e avisos de Hong Kong. Chame hk_weather_current. O texto oficial diz que fala com o Observatório de Hong Kong e devolve Current conditions + active warnings. Não há tabela de campos nem estação de exemplo; em caso de sucesso deve ver condições atuais e avisos ativos, e tratá-los como resultado de API em direto, não cache offline.

Caso 2: viagens e chegadas MTR. Chame search_mtr_schedule. O texto oficial diz que os dados vêm de data.gov.hk, para planeamento de transbordos e chegadas em direto, cobrindo as 10 linhas, 98 estações. Não escreve como passar origem e destino; use só os campos que o cliente mostra. Em caso de sucesso deve ver informação de viagem ou chegada. Não leia isto como forma de alterar o horário.

A mesma página também nomeia hk_typhoon_signal, para o estado estruturado de tufão, chuva intensa e outros avisos ativos, também com o Observatório de Hong Kong. Não precisa de o chamar na primeira tentativa.

Limites

O pré-requisito é Node.js 18+. As ferramentas de Hong Kong não precisam de .env; as Amap/Gaode precisam de um segredo segundo o modelo oficial. Esta página não escreve o nome da variável do segredo; não o adivinhe na primeira tentativa. Cada ferramenta atinge uma API em linha, sai à rede e pode expor a linha ou o tema meteorológico consultado.

O texto oficial não escreve limite de ritmo, quota nem duração de cache. Se um upstream cair, a ferramenta diz-o; system_run_selftest pode sondar se cada upstream é alcançável. Não há anulação nem rollback. Estas consultas são dados públicos só de leitura, mas não são risco zero.

dist/stdio.js na configuração tem de apontar para o artefacto construído nesta máquina. Não use um caminho de código-fonte não construído, nem invente nomes de ferramentas continentais não nomeadas.