MCP Weather

Servidor meteorológico MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona pronósticos meteorológicos cada 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:

Luego ejecute el servidor meteorológico MCP directamente con:

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

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 ):

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
• Proporciona datos meteorológicos por hora para cualquier ubicación.
• Acceda a la temperatura, las condiciones 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 para la ciudad de Nueva York?"
   • "¿Lloverá mañana en Londres?"
   • "¿Qué calor hará en Tokio esta tarde?"

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 diarios: Opción para recuperar un resumen para los próximos días.
• Pronósticos horarios extendidos: más allá de 12 horas, por ejemplo, 24 o 48 horas.
• Más opciones de configuración: por ejemplo, unidades preferidas (Celsius/Fahrenheit) mediante entrada.

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.