What can you do with this server?

The MCP Weather Server provides real-time weather information and forecasts using the Open-Meteo API with the following capabilities: * Get current weather by city: Fetch weather conditions using city name with optional country code. * Get weather forecast: Retrieve forecasts for up to 7 days for a given city. * Get weather by coordinates: Obtain weather data using GPS coordinates (latitude and longitude). * Multilingual support: Access weather descriptions in multiple languages (French, English, Spanish, German). * Customizable units: Choose between metric (Celsius), imperial (Fahrenheit), or Kelvin measurements. * Docker-ready: Optimized for production deployment using Docker and Docker Compose. * TypeScript strict: Ensures robust parameter validation.

Which integrations are available for this server?

Enables integration with ChatGPT through plugins or custom integrations, providing real-time weather data and forecasts

How do I use MCP Weather Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Weather Server what's the weather forecast for Paris this weekend?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

The MCP Weather Server provides real-time weather information and forecasts using the Open-Meteo API with the following capabilities:

Get current weather by city: Fetch weather conditions using city name with optional country code.
Get weather forecast: Retrieve forecasts for up to 7 days for a given city.
Get weather by coordinates: Obtain weather data using GPS coordinates (latitude and longitude).
Multilingual support: Access weather descriptions in multiple languages (French, English, Spanish, German).
Customizable units: Choose between metric (Celsius), imperial (Fahrenheit), or Kelvin measurements.
Docker-ready: Optimized for production deployment using Docker and Docker Compose.
TypeScript strict: Ensures robust parameter validation.

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

Related MCP server: Weather MCP Server

🚀 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

MCP Weather Server