MCP Weather Server

Serveur MCP Weather

Serveur Model Context Protocol (MCP) fournissant des informations météorologiques en temps réel via l'API Open-Meteo.

✨ Fonctionnalités

🌤️ Météo actuelle par nom de ville ou coordonnées
📅 Prévisions jusqu'à 7 jours
🌍 Support multilingue (français, anglais, espagnol, allemand, etc.)
🆓 API gratuite Open-Meteo (sans clé requise)
🐳 Prêt pour Docker avec configuration de production optimisée
📊 TypeScript strict avec validation des paramètres

🚀 Installation et démarrage rapide

Prérequis

Node.js 18+
Docker et Docker Compose (optionnel)

Méthode 1: Démarrage local

# Installation des dépendances
npm install

# Construction
npm run build

# Démarrage
npm start

Méthode 2: Docker (recommandé pour production)

# Déploiement automatique
chmod +x deploy.sh
./deploy.sh

📋 Outils MCP disponibles

`get_weather`

Obtient la météo actuelle pour une ville.

{
  "city": "Paris",
  "countryCode": "FR",
  "lang": "fr"
}

`get_weather_forecast`

Obtient les prévisions météo (1-7 jours).

{
  "city": "London",
  "days": 5,
  "lang": "en"
}

`get_weather_by_coordinates`

Obtient la météo par coordonnées GPS.

{
  "latitude": 48.8566,
  "longitude": 2.3522,
  "lang": "fr"
}

⚙️ Configuration

Copiez .env.example vers .env et ajustez si nécessaire :

# Port du serveur (optionnel)
MCP_SERVER_PORT=3000

# Langue par défaut
DEFAULT_LANGUAGE=fr

# Environnement
NODE_ENV=production

🛠️ Développement

# Mode développement avec rechargement automatique
npm run dev

# Vérification du code
npm run lint
npm run typecheck

# Formatage du code
npm run format

📦 Structure du projet

src/
├── index.ts              # Point d'entrée principal
├── services/
│   └── weatherService.ts # Service API Open-Meteo
├── utils/
│   ├── formatter.ts      # Formatage des réponses
│   └── validation.ts     # Validation des paramètres
├── types/
│   └── weather.ts        # Types TypeScript
└── constants/
    └── weather.ts        # Constantes et configurations

🐳 Production avec Docker

Le projet inclut une configuration Docker optimisée avec :

Build multi-stage pour une image légère
Utilisateur non-root pour la sécurité
Healthchecks intégrés
Logs structurés

# Construction manuelle
docker build -t mcp-weather-server .

# Ou via docker-compose
docker-compose up -d

🔧 Intégration MCP

Ce serveur est compatible avec tous les clients MCP. Exemple d'utilisation avec Claude Desktop :

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/chemin/vers/dist/index.js"]
    }
  }
}

📄 License

MIT - Voir le fichier LICENSE pour plus de détails.

Développé avec ❤️ en TypeScript

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

A Model Context Protocol server that provides real-time weather information and 5-day forecasts to AI assistants, supporting multiple languages and flexible units.

Related MCP Servers

Juhe Weather MCP Serverofficial
juhemcp
-
security
-
license
-
quality
Provides a Model Context Protocol server that enables large language models to query and retrieve real-time weather forecasts for cities and regions across China.
Last updated -
Python
Weather MCP Server
akaramanapp
A
security
F
license
A
quality
A Model Context Protocol server that provides AI agents with tools to retrieve weather alerts and detailed forecasts for US locations using the National Weather Service API.
Last updated -
2
80
TypeScript
Caiyun Weather MCP Server
marcusbai
A
security
F
license
A
quality
A Model Context Protocol server that provides comprehensive weather data querying capabilities based on the Caiyun Weather API, supporting real-time weather, forecasts, and alerts with multi-language support.
Last updated -
7
2
TypeScript
Weather MCP
kaisumi
-
security
-
license
-
quality
A Model Context Protocol server that provides current weather information and 3-day forecasts for specified cities using the Open-Meteo API.
Last updated -
Python

View all related MCP servers