Open-Meteo MCP Server

Un servidor complet del Model Context Protocol (MCP) que proporciona accés a les API meteorològiques d'Open-Meteo per a l'ús amb models de llenguatge gran.

Característiques

Aquest servidor MCP ofereix accés complet a les API d'Open-Meteo, incloent:

API Meteorològiques Bàsiques

• Weather Forecast (weather_forecast) - pronòstics de 7 dies amb resolució horària i diària
• Weather Archive (weather_archive) - dades històriques ERA5 des de 1940 fins a l'actualitat
• Air Quality (air_quality) - PM2.5, PM10, ozó, diòxid de nitrogen i altres contaminants
• Marine Weather (marine_weather) - altura de les ones, període, direcció i temperatura de la superfície marina
• Elevation (elevation) - dades del model digital d'elevació per a coordenades donades
• Geocoding (geocoding) - cerca de llocs a tot el món per nom o codi postal, obté coordenades i informació detallada del lloc

Models Meteorològics Especialitzats

• DWD ICON (dwd_icon_forecast) - model de resolució alta del servei meteorològic alemany per a Europa
• NOAA GFS (gfs_forecast) - model global del servei meteorològic dels EUA amb dades de resolució alta d'Amèrica del Nord
• Météo-France (meteofrance_forecast) - models AROME i ARPEGE del servei meteorològic francès
• ECMWF (ecmwf_forecast) - Centre Europeu de Pronòstics Meteorològics de Mitjà Rang
• JMA (jma_forecast) - model de resolució alta de l'Agència Meteorològica Japonesa per a Àsia
• MET Norway (metno_forecast) - servei meteorològic noruec per als països nòrðics
• Environment Canada GEM (gem_forecast) - model del servei meteorològic canadenc

Eines de Pronòstic Avançades

• Flood Forecast (flood_forecast) - descàrrega de riu i pronòstics d'inundació del GloFAS (Global Flood Awareness System)
• Seasonal Forecast (seasonal_forecast) - pronòstics a llarg termini fins a 9 mesos
• Climate Projections (climate_projection) - projeccions de canvi climàtic CMIP6 per a diferents escenaris de escalfament
• Ensemble Forecast (ensemble_fore 血) - múltiples execucions de models que mostren la incertesa del pronòstic

Instal·lació

Mètode 1: Utilitzant npx (Recomanat)

No cal instal·lar! El servidor s'executarà directament via npx.

Mètode 2: Instal·lació Global via npm

npm install -g open-meteo-mcp-server

Mètode 3: Des del Codi Font (Desenvolupament)

# Clone the repository
git clone https://github.com/cmer81/open-meteo-mcp.git
cd open-meteo-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuració

Configuració de Claude Desktop

Configuració Simple (Recomanada)

Afegeix la següent configuració al teu fitxer de configuració de Claude Desktop:

{ "mcpServers": { "open-meteo": { "command": "npx", "args": ["open-meteo-mcp-server"] } } }

Configuració Completa (amb variables d'entorn)

{ "mcpServers": { "open-meteo": { "command": "npx", "args": ["open-meteo-mcp-server"], "env": { "OPEN_METEO_API_URL": "https://api.open-meteo.com", "OPEN_METEO_AIR_QUALITY_API_URL": "https://air-quality-api.open-meteo.com", "OPEN_METEO_MARINE_API_URL": "https://marine-api.open-meteo.com", "OPEN_METEO_ARCHIVE_API_URL": "https://archive-api.open-meteo.com", "OPEN_METEO_SEASONAL_API_URL": "https://api.open-meteo.com", "OPEN_METEO_GLOFAS_API_URL": "https://glofas-api.open-meteo.com" } } } }

Configuració de Desenvolupament Local

{ "mcpServers": { "open-meteo": { "command": "npx", "args": ["open-meteo-mcp-server"], "env": { "OPEN_METEO_API_URL": "https://api.open-meteo.com", "OPEN_METEO_AIR_QUALITY_API_URL": "https://air-quality-api.open-meteo.com", "OPEN_METEO_MARINE_API_URL": "https://marine-api.open-meteo.com", "OPEN_METEO_ARCHIVE_API_URL": "https://archive-api.open-meteo.com", "OPEN_METEO_SEASONAL_API_URL": "https://api.open-meteo.com", "OPEN_METEO_GLOFAS_API_URL": "https://glofas-api.open-meteo.com" } } } }

Configuració d'Instància Personalitzada

{ "mcpServers": { "open-meteo": { "command": "npx", "args": ["open-meteo-mcp-server"], "env": { "OPEN_METEO_API_URL": "https://api.open-meteo.com", "OPEN_METEO_AIR_QUALITY_API_URL": "https://air-quality-api.open-meteo.com", "OPEN_METEO_MARINE_API_URL": "https://marine-api.open-meteo.com", "OPEN_METEO_ARCHIVE_API_URL": "https://archive-api.open-meteo.com", "OPEN_METEO_SEASONAL_API_URL": "https://api.open-meteo.com", "OPEN_METEO_GLOFAS_API_URL": "https://glofas-api.open-meteo.com" } } } }

Variables d'Entorn

Totes les variables d'entorn són opcionals i tenen valors per defecte raonables:

• OPEN_METEO_API_URL - URL base per a l'API de pronòstic d'Open-Meteo (per defecte: https://api.open-meteo.com)
• OPEN_METEO_AIR_QUALITY_API_URL - URL base per a l'API de qualitat de l'aire (per defecte: https://air-quality-api.open-meteo.com)
• OPEN_METEO_MARINE_API_URL - URL base per a l'API marítima (per defecte: https://marine-api.open-meteo.com)
• OPEN_METEO_ARCHIVE_API_URL - URL base per a l'API d'arxiu (per defecte: https://archive-api.open-meteo.com)
• OPEN_METEO_SEASONAL_API_URL - URL base per a l'API de pronòstics estacionals (per defecte: https://api.open-meteo.com)
• OPEN_METEO_GLOFAS_API_URL - URL base per a l'API GloFAS (per defecte: https://glofas-api.open-meteo.com