China Weather

Consulte informações meteorológicas e alertas meteorológicos para cidades chinesas usando a API QWeather.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP de Consulta de Clima na China

Servidor de Model Context Protocol (MCP) baseado na API de Clima QWeather, copiado do demo oficial do site do MCP, usado para consultar informações meteorológicas e alertas de clima de cidades chinesas.

code ~/Library/Application\ Support/Claude/claude_desktop_config.json 

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "your_dir/weather/build/index.js"
      ]
    }
  }
}

alt text

alt text

Funcionalidades

  • 🌤️ Previsão do tempo: Obtenha previsão do tempo de 1 a 7 dias para qualquer cidade chinesa
  • ⚠️ Alertas meteorológicos: Consulte informações de alertas meteorológicos em tempo real da cidade
  • 🏙️ Busca inteligente de cidades: Suporte à busca por nomes de cidades em chinês
  • 📊 Informações detalhadas: Fornece dados meteorológicos detalhados como temperatura, umidade, vento, precipitação, índice UV, etc.

Instalação e Configuração

1. Obtenha a chave da API

Acesse a Plataforma de Desenvolvimento QWeather para registrar uma conta e obter uma chave de API gratuita.

2. Configure as variáveis de ambiente

const QWEATHER_API_BASE = "https://ph5ctubwqh.re.qweatherapi.com";
const API_KEY = "dedccbe28e4d43a28e9db478df8aca71";

3. Instale as dependências

npm install

4. Compile o projeto

npm run build

Ferramentas Disponíveis

1. get-weather-forecast

Obtenha a previsão do tempo da cidade

Parâmetros:

  • city (string): Nome da cidade, como: Pequim, Xangai, Cantão, etc.
  • days (number, opcional): Dias de previsão, 1-7 dias, padrão 3 dias

Exemplo:

{
  "city": "北京",
  "days": 5
}

2. get-weather-warnings

Obtenha informações de alertas meteorológicos da cidade

Parâmetros:

  • city (string): Nome da cidade, como: Pequim, Xangai, Cantão, etc.

Exemplo:

{
  "city": "上海"
}

Cidades Suportadas

Suporta todas as principais cidades da China continental, Hong Kong, Macau e Taiwan, incluindo, mas não se limitando a:

  • Municípios: Pequim, Xangai, Tianjin, Chongqing
  • Capitais provinciais: Cantão, Shenzhen, Hangzhou, Nanquim, Wuhan, Chengdu, Xi'an, etc.
  • Cidades de nível distrital: Suzhou, Wuxi, Foshan, Dongguan, Dalian, etc.
  • Cidades de nível municipal: Kunshan, Jiangyin, Zhangjiagang, etc.

Descrição dos Dados

A previsão do tempo inclui as seguintes informações:

  • 📅 Data
  • 🌡️ Temperatura máxima/mínima
  • ☀️ Condições climáticas diurnas
  • 🌙 Condições climáticas noturnas
  • 💨 Direção e intensidade do vento
  • 💧 Umidade
  • 🌧️ Precipitação
  • 📊 Pressão atmosférica
  • 👁️ Visibilidade
  • ☀️ Índice UV
  • 🌅 Horário do nascer e pôr do sol

Os alertas meteorológicos incluem:

  • ⚠️ Título e tipo do alerta
  • 📊 Nível do alerta
  • 📍 Área afetada
  • ⏰ Horário de vigência
  • 📋 Descrição detalhada

Tratamento de Erros

O servidor trata os seguintes erros comuns:

  • Chave de API inválida ou não configurada
  • Nome da cidade inexistente
  • Problemas de conexão de rede
  • Limites de requisição da API

Desenvolvimento

Estrutura do Projeto

weather/
├── src/
│   └── index.ts          # 主服务器文件
├── build/
│   └── index.js          # 编译后的文件
├── package.json
├── tsconfig.json
└── README.md

Desenvolvimento Local

  1. Modifique o código-fonte src/index.ts
  2. Recompile: npm run build
  3. Teste a execução: npm start

Licença

Licença MIT

Contribuição

Contribuições são bem-vindas! Envie Issues e Pull Requests!

Links Relacionados