Servidor meteorológico MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona pronósticos meteorológicos diarios y por hora mediante la API de AccuWeather.

Inicio rápido

Necesita una clave API de AccuWeather (nivel gratuito disponible).
Regístrate aquí y crea una aplicación para obtener tu clave.

Exporte su clave API como una variable de entorno:

export ACCUWEATHER_API_KEY=your_api_key_here

Luego ejecute el servidor meteorológico MCP directamente con:

npx -y @timlukahorstmann/mcp-weather

O bien, para acceso HTTP/REST a través de supergateway :

npx -y supergateway --stdio "npx -y @timlukahorstmann/mcp-weather" \
  --port 4004 \
  --baseUrl http://127.0.0.1:4004 \
  --ssePath /messages \
  --messagePath /message \
  --cors "*" \
  --env ACCUWEATHER_API_KEY="$ACCUWEATHER_API_KEY"

Related MCP server: Weather MCP Server

Ejemplo de configuración del servidor MCP

Para la integración con Claude Desktop u otros clientes compatibles con MCP, agregue esto a su configuración (por ejemplo, claude_desktop_config.json ):

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@timlukahorstmann/mcp-weather"],
      "env": {
        "ACCUWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Descripción general

Este servidor MCP permite que modelos lingüísticos de gran tamaño (como Claude) accedan a datos meteorológicos en tiempo real. Al integrarse con un LLM, permite al modelo:

• Obtenga pronósticos meteorológicos precisos y actualizados

• Proporcionar datos meteorológicos por hora para las próximas 12 horas.

• Acceda a pronósticos meteorológicos diarios de hasta 15 días

• Muestra datos en unidades métricas (°C) e imperiales (°F)

• Ver información sobre temperatura, condiciones, precipitaciones y otros detalles meteorológicos.

Prerrequisitos

• Node.js ≥18

• Una clave API de AccuWeather (configurada a través de .env o su shell)

Configuración

1. Clonar este repositorio:

   git clone https://github.com/TimLukaHorstmann/mcp-weather.git
   cd mcp-weather

2. Instalar dependencias:

   npm install

3. Obtenga una clave API de AccuWeather:

   • Regístrese en la API de AccuWeather

   • Crea una nueva aplicación y obtén una clave API

4. Crea un archivo .env con tu clave API:

   ACCUWEATHER_API_KEY=your_api_key_here

5. Construir el proyecto:

   npm run build

Uso con Claude Desktop

1. Configurar Claude Desktop para utilizar este servidor MCP:

   • Abra Claude Desktop

   • Vaya a Configuración > Desarrollador > Editar configuración

   • Agregue lo siguiente a su claude_desktop_config.json :

   {
     "mcpServers": {
       "weather": {
         "command": "npx",
         "args": ["-y", "@timlukahorstmann/mcp-weather"],
         "env": {
           "ACCUWEATHER_API_KEY": "your_api_key_here"
         }
       }
     }
   }

2. Reiniciar Claude Desktop

3. En una nueva conversación, habilite el servidor MCP haciendo clic en el ícono del enchufe y seleccionando "clima".

4. Ahora puedes pedirle a Claude pronósticos del tiempo como:

   • "¿Cuál es el pronóstico del tiempo por horas para la ciudad de Nueva York?"

   • "Dame el pronóstico de cinco días para Londres."

   • "¿Cómo estará el tiempo en Tokio esta semana en Fahrenheit?"

   • "¿Lloverá mañana en San Francisco?"

Herramientas disponibles

Pronóstico del tiempo por hora

• Nombre de la herramienta: weather-get_hourly

• Proporciona pronósticos por hora para las próximas 12 horas.

• Parámetros:

  • sessionId (obligatorio): identificador único para la sesión

  • location (obligatorio): Ciudad o nombre de la ubicación

  • units (opcionales): "métricas" (Celsius, predeterminadas) o "imperiales" (Fahrenheit)

Pronóstico del tiempo diario

• Nombre de la herramienta: weather-get_daily

• Proporciona pronósticos diarios de hasta 15 días.

• Parámetros:

  • sessionId (obligatorio): identificador único para la sesión

  • location (obligatorio): Ciudad o nombre de la ubicación

  • days (opcional): Número de días de pronóstico (1, 5, 10 o 15; el valor predeterminado es 5)

  • units (opcionales): "métricas" (Celsius, predeterminadas) o "imperiales" (Fahrenheit)

Desarrollo

• Instalar dependencias de desarrollo: npm install

• Limpie su código: npm run lint

• Construir: npm run build

• Ejecutar pruebas: npm test

• Iniciar en modo de desarrollo: npm run dev

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Mejoras futuras

Siempre buscamos mejorar el Servidor Meteorológico MCP. Estas son algunas de las características que estamos considerando para futuras versiones:

• Pronósticos horarios extendidos: más allá de 12 horas, por ejemplo, 24 o 48 horas.

• Alertas meteorológicas: integración con la API de alertas meteorológicas severas de AccuWeather.

• Autocompletar ubicación: búsqueda de ubicación mejorada con sugerencias de autocompletar.

• Datos meteorológicos históricos: acceso a condiciones climáticas pasadas.

Si tienes ideas para otras funciones, ¡no dudes en abrir un problema!

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.