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"
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
- Clonar este repositorio:
git clone https://github.com/TimLukaHorstmann/mcp-weather.git
cd mcp-weather
- Instalar dependencias:
- Obtenga una clave API de AccuWeather:
- Crea un archivo
.env con tu clave API:ACCUWEATHER_API_KEY=your_api_key_here
- Construir el proyecto:
Uso con Claude Desktop
- 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"
}
}
}
}
- Reiniciar Claude Desktop
- En una nueva conversación, habilite el servidor MCP haciendo clic en el ícono del enchufe y seleccionando "clima".
- 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ónlocation (obligatorio): Ciudad o nombre de la ubicaciónunits (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ónlocation (obligatorio): Ciudad o nombre de la ubicacióndays (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.