Yarflam/weather-mcp-server

🌤️ 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

1. Install dependencies:

cd weather-mcp-server
npm install

2. 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_cities to 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

📦 Dependencies

• @modelcontextprotocol/sdk: Official MCP SDK
• node-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

1. Installer les dépendances :

cd weather-mcp-server
npm install

2. 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_cities pour 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

📦 Dépendances

• @modelcontextprotocol/sdk : SDK officiel MCP
• node-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