🌤️ Weather MCP Server (Free & Sydney Default)
A Model Context Protocol (MCP) server for retrieving weather data via the free Open-Meteo API. No API key required! Sydney is configured as the default city.
✨ Features
- 🆓 100% free - Uses Open-Meteo API (no key required)
- 🇦🇺 Sydney by default - Perfect for Australia
- 🌍 Global support - All cities worldwide
- 🗓️ 7-day forecasts - Detailed weather data
- 🔍 City search - Find coordinates easily
- 🌐 Multi-language - English interface with French support
🚀 Quick Installation
- Install dependencies:
cd weather-mcp-server
npm install
- Test immediately:
npm start
That's it! No additional configuration needed.
🛠️ Configuration with Claude Desktop
Add this configuration to your claude_desktop_config.json:
Windows
File: %APPDATA%\Claude\claude_desktop_config.json
macOS
File: ~/Library/Application Support/Claude/claude_desktop_config.json
JSON Configuration
{
"mcpServers": {
"weather": {
"command": "node",
"args": [
"YOUR_FULL_PATH_HERE\\weather-mcp-server\\src\\index.js"
]
}
}
}
Note: Adjust the path according to your installation!
🔧 Available Tools
1. get_current_weather
Current weather (Sydney by default)
- city (optional): City name (default: Sydney)
- country (optional): Country code (AU, FR, etc.)
2. get_weather_forecast
7-day forecasts (Sydney by default)
- city (optional): City name (default: Sydney)
- country (optional): Country code
- days (optional): Number of days 1-7 (default: 7)
3. get_weather_by_coordinates
Weather by GPS coordinates (Sydney by default)
- lat (optional): Latitude (default: -33.8688)
- lon (optional): Longitude (default: 151.2093)
- days (optional): Number of days 1-7 (default: 1)
4. search_cities
Search cities worldwide
- query (required): City name to search
📝 Usage Examples with Claude
Once configured, you can ask Claude:
Default weather (Sydney):
- "What's the weather?"
- "Current weather"
- "Week forecast"
Other cities:
- "Weather in Paris"
- "5-day forecast for London"
- "Temperature in Tokyo"
City search:
- "Find cities named Melbourne"
- "Search for Springfield"
By coordinates:
- "Weather at coordinates 48.8566, 2.3522"
🌟 Open-Meteo Benefits
- ✅ Completely free - No reasonable usage limits
- ✅ No registration - Works immediately
- ✅ Accurate data - Professional weather models
- ✅ Modern API - Simple and fast JSON
- ✅ Reliable - Stable European service
🗺️ Why Sydney as Default?
Sydney is configured as the default city because:
- 🏙️ Major metropolis - Representative of Australia
- 🌤️ Varied climate - Good weather example
- 🇦🇺 Unique timezone - GMT+10/+11 depending on season
- 📍 Exact coordinates - -33.8688°, 151.2093°
🐛 Troubleshooting
"City not found"
- Check spelling
- Try with country code: "Paris, FR"
- Use
search_citiesto find the correct name
Network error
- Check your internet connection
- Open-Meteo is sometimes temporarily unavailable
Server won't start
- Check Node.js:
node --version(≥16 required) - Install dependencies:
npm install
🔄 Comparison with OpenWeatherMap
| Criteria | Open-Meteo | OpenWeatherMap |
|---|---|---|
| Price | 🆓 Free | 🆓 Free (limited) |
| API Key | ❌ None | ✅ Required |
| Registration | ❌ None | ✅ Mandatory |
| Forecasts | 7 days | 5 days (free) |
| Accuracy | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Reliability | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
📦 Dependencies
@modelcontextprotocol/sdk: Official MCP SDKnode-fetch: HTTP client for API requests
No heavy external dependencies!
📄 License
MIT - Use freely in your projects!
🇦🇺 Made with ❤️ for Sydney and the world
🇫🇷 Version Française / French Version
🌤️ Serveur MCP Météo (Gratuit & Sydney par défaut)
Un serveur MCP (Model Context Protocol) pour récupérer des données météorologiques via l'API gratuite Open-Meteo. Aucune clé API requise ! Sydney est configuré comme ville par défaut.
✨ Caractéristiques
- 🆓 100% gratuit - Utilise l'API Open-Meteo (pas de clé requise)
- 🇦🇺 Sydney par défaut - Parfait pour l'Australie
- 🌍 Support mondial - Toutes les villes du monde
- 🗓️ Prévisions 7 jours - Météo détaillée
- 🔍 Recherche de villes - Trouve les coordonnées facilement
- 🌐 Interface française - Descriptions en français
🚀 Installation rapide
- Installer les dépendances :
cd weather-mcp-server
npm install
- Tester immédiatement :
npm start
C'est tout ! Aucune configuration supplémentaire nécessaire.
🛠️ Configuration avec Claude Desktop
Ajoutez cette configuration dans votre claude_desktop_config.json :
Windows
Fichier : %APPDATA%\Claude\claude_desktop_config.json
macOS
Fichier : ~/Library/Application Support/Claude/claude_desktop_config.json
Configuration JSON
{
"mcpServers": {
"weather": {
"command": "node",
"args": [
"REMPLACEZ_PAR_VOTRE_CHEMIN\\weather-mcp-server\\src\\index.js"
]
}
}
}
Note : Adaptez le chemin selon votre installation !
🔧 Outils disponibles
1. get_current_weather
Météo actuelle (Sydney par défaut)
- city (optionnel) : Nom de la ville (défaut: Sydney)
- country (optionnel) : Code pays (AU, FR, etc.)
2. get_weather_forecast
Prévisions sur 7 jours (Sydney par défaut)
- city (optionnel) : Nom de la ville (défaut: Sydney)
- country (optionnel) : Code pays
- days (optionnel) : Nombre de jours 1-7 (défaut: 7)
3. get_weather_by_coordinates
Météo par coordonnées GPS (Sydney par défaut)
- lat (optionnel) : Latitude (défaut: -33.8688)
- lon (optionnel) : Longitude (défaut: 151.2093)
- days (optionnel) : Nombre de jours 1-7 (défaut: 1)
4. search_cities
Recherche de villes dans le monde
- query (requis) : Nom de la ville à rechercher
📝 Exemples d'utilisation avec Claude
Une fois configuré, vous pouvez demander à Claude :
Météo par défaut (Sydney) :
- "Quelle est la météo ?"
- "Météo actuelle"
- "Prévisions de la semaine"
Autres villes :
- "Météo à Paris"
- "Prévisions pour Londres sur 5 jours"
- "Température à Tokyo"
Recherche de villes :
- "Trouve les villes appelées Melbourne"
- "Cherche Springfield"
Par coordonnées :
- "Météo aux coordonnées 48.8566, 2.3522"
🌟 Avantages d'Open-Meteo
- ✅ Totalement gratuit - Pas de limite d'usage raisonnable
- ✅ Pas d'inscription - Fonctionne immédiatement
- ✅ Données précises - Modèles météo professionnels
- ✅ API moderne - JSON simple et rapide
- ✅ Fiable - Service européen stable
🗺️ Pourquoi Sydney par défaut ?
Sydney est configuré comme ville par défaut car :
- 🏙️ Grande métropole - Représentative de l'Australie
- 🌤️ Climat varié - Bon exemple météorologique
- 🇦🇺 Fuseau unique - GMT+10/+11 selon saison
- 📍 Coordonnées exactes - -33.8688°, 151.2093°
🐛 Dépannage
"Ville non trouvée"
- Vérifiez l'orthographe
- Essayez avec le code pays : "Paris, FR"
- Utilisez
search_citiespour trouver le bon nom
Erreur de réseau
- Vérifiez votre connexion internet
- Open-Meteo est parfois temporairement indisponible
Le serveur ne démarre pas
- Vérifiez Node.js :
node --version(≥16 requis) - Installez les dépendances :
npm install
🔄 Comparaison avec OpenWeatherMap
| Critère | Open-Meteo | OpenWeatherMap |
|---|---|---|
| Prix | 🆓 Gratuit | 🆓 Gratuit (limité) |
| Clé API | ❌ Aucune | ✅ Requise |
| Inscription | ❌ Aucune | ✅ Obligatoire |
| Prévisions | 7 jours | 5 jours (gratuit) |
| Précision | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Fiabilité | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
📦 Dépendances
@modelcontextprotocol/sdk: SDK officiel MCPnode-fetch: Client HTTP pour les requêtes API
Pas de dépendance externe lourde !
📄 Licence
MIT - Utilisez librement dans vos projets !
🇦🇺 Fait avec ❤️ pour Sydney et le monde entier