mcp-meteoblue

Un servidor MCP para la meteoblue Weather API, escrito en JavaScript. Permite a los clientes MCP buscar lugares, consultar previsiones mediante los paquetes disponibles a través de la Free Weather API y solicitar imágenes de meteogramas de previsión.

Herramientas

• search_locations resuelve ciudades, códigos postales y códigos de aeropuerto IATA/ICAO mediante meteoblue Location Search.

• get_forecast acepta un nombre de lugar o coordenadas y devuelve el JSON de previsión. Por defecto, incluye el tiempo actual, por horas y diario.

• get_forecast_image acepta un nombre de lugar o coordenadas y devuelve una imagen de previsión directamente al cliente MCP.

Los nombres de lugar que se pasan a las herramientas de previsión o de imagen se resuelven siempre a través de la API oficial de meteoblue Location Search. Los parámetros de los paquetes de previsión están restringidos a los paquetes indicados en la documentación de la Free Weather API.

!NOTE] La documentación actual de la Free Weather API de meteoblue indica que las imágenes requieren un nivel de acceso superior. La herramienta de imagen está incluida para claves con permiso de Image API; de lo contrario, devolverá un error de autorización claro.

Related MCP server: mcp-weather-server

Requisitos

• Node.js 20 o superior

• Una clave de API de meteoblue

Mantén la clave privada. Este servidor la lee de la variable METEOBLUE_API_KEY; nunca forma parte del paquete ni de los argumentos de las herramientas de MCP.

Ejecutar desde npm

Añade este servidor stdio a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "meteoblue": {
      "command": "npx",
      "args": ["-y", "mcp-meteoblue"],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

O ejecútalo directamente:

METEOBLUE_API_KEY=your_api_key_here npx -y mcp-meteoblue

El servidor usa stdio, por lo que no produce a propósito ninguna salida de terminal normal mientras espera a un cliente MCP.

Docker

Construye la imagen en local:

docker build -t mcp-meteoblue .

Configura un servidor stdio basado en Docker en tu cliente MCP:

{
  "mcpServers": {
    "meteoblue": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "METEOBLUE_API_KEY",
        "mcp-meteoblue"
      ],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

El contenedor se ejecuta como el usuario node sin privilegios. Mantén el stdin abierto con -i porque la comunicación MCP usa stdio.

Desarrollo local

npm install
npm test
METEOBLUE_API_KEY=your_api_key_here npm start

Configura un cliente MCP para que apunte a node /absolute/path/to/mcp-meteoblue/src/index.js y defina la variable de entorno en la configuración de ese cliente.

Lanzamientos

GitHub Actions ejecuta la batería de pruebas y valida el tarball de npm en Node.js 20, 22, 24 y 26 para cada push y pull request. Dependabot revisa semanalmente las dependencias de npm y de GitHub Actions.

Subir una etiqueta de Git con v* activa .github/workflows/publish.yml. El flujo de trabajo usa la publicación de confianza de npm (OIDC) y adjunta automáticamente el origen. Configura el publicador de confianza de npm con:

• GitHub: unixfox

• Repositorio: mcp-meteoblue

• Workflow: publish.yml

• Entorno: npm

No se almacena ningún token de npm en GitHub cuando se configuras la publicación de confianza.

Alcance de la API

El servidor solo llama:

• https://www.meteoblue.com/{language}/server/search/query3

• https://my.meteoblue.com/packages/{packages}

• https://my.meteoblue.com/images/{forecast-image-type}

No expone las APIs de meteoblue History, Dataset, Maps, Measurements ni otras APIs.

Licencia

MIT