China Weather

Servidor MCP de Consulta Meteorológica de China

Servidor de Protocolo de Contexto de Modelo (MCP) basado en la API de QWeather, copiado de la demo oficial del sitio web de MCP, utilizado para consultar información meteorológica y alertas meteorológicas de ciudades chinas.

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

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

Características

• 🌤️ Pronóstico del tiempo: Obtén pronósticos meteorológicos de 1 a 7 días para cualquier ciudad de China
• ⚠️ Alertas meteorológicas: Consulta información de alertas meteorológicas en tiempo real para ciudades
• 🏙️ Búsqueda inteligente de ciudades: Admite búsqueda por nombre de ciudad en chino
• 📊 Información detallada: Proporciona datos meteorológicos detallados como temperatura, humedad, viento, precipitación, índice UV, etc.

Instalación y configuración

1. Obtén una clave de API

Visita Plataforma de desarrollo de QWeather para registrarte y obtener una clave de API gratuita.

2. Configura las variables de entorno

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

3. Instala las dependencias

npm install

4. Compila el proyecto

npm run build

Herramientas disponibles

1. get-weather-forecast

Obtén el pronóstico meteorológico de una ciudad

Parámetros:

• city (string): Nombre de la ciudad, por ejemplo: Pekín, Shanghái, Cantón, etc.
• days (number, opcional): Días de pronóstico, 1-7 días, por defecto 3 días

Ejemplo:

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

2. get-weather-warnings

Obtén información de alertas meteorológicas de una ciudad

Parámetros:

• city (string): Nombre de la ciudad, por ejemplo: Pekín, Shanghái, Cantón, etc.

Ejemplo:

{
  "city": "上海"
}

Ciudades compatibles

Se admiten todas las ciudades principales de China continental, Hong Kong, Macao y Taiwán, incluyendo pero no limitado a:

• Municipios: Pekín, Shanghái, Tianjin, Chongqing
• Capitales de provincia: Cantón, Shenzhen, Hangzhou, Nankín, Wuhan, Chengdu, Xi'an, etc.
• Ciudades de nivel prefectura: Suzhou, Wuxi, Foshan, Dongguan, Dalian, etc.
• Ciudades de nivel condado: Kunshan, Jiangyin, Zhangjiagang, etc.

Descripción de datos

El pronóstico meteorológico incluye la siguiente información:

• 📅 Fecha
• 🌡️ Temperatura máxima/mínima
• ☀️ Condiciones meteorológicas diurnas
• 🌙 Condiciones meteorológicas nocturnas
• 💨 Dirección y fuerza del viento
• 💧 Humedad
• 🌧️ Precipitación
• 📊 Presión atmosférica
• 👁️ Visibilidad
• ☀️ Índice UV
• 🌅 Hora de salida y puesta del sol

Las alertas meteorológicas incluyen:

• ⚠️ Título y tipo de alerta
• 📊 Nivel de alerta
• 📍 Área afectada
• ⏰ Hora de vigencia
• 📋 Descripción detallada

Manejo de errores

El servidor maneja los siguientes errores comunes:

• Clave de API inválida o no configurada
• Nombre de ciudad inexistente
• Problemas de conexión de red
• Límites de solicitudes de API

Desarrollo

Estructura del proyecto

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

Desarrollo local

1. Modifica el código fuente src/index.ts
2. Recompila: npm run build
3. Prueba de ejecución: npm start

Licencia

Licencia MIT

Contribuciones

¡Se aceptan Issues y Pull Requests!

Enlaces relacionados

• Documentación de la API de QWeather
• Protocolo de Contexto de Modelo
• SDK de MCP