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

1. 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

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 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 Franaise / French Version

Serveur MCP Mto (Gratuit & Sydney par dfaut)

Un serveur MCP (Model Context Protocol) pour rcuprer des donnes mtorologiques via l'API gratuite Open-Meteo. Aucune cl API requise ! Sydney est configur comme ville par dfaut.

Caractristiques

• 100% gratuit - Utilise l'API Open-Meteo (pas de cl requise)
• Sydney par dfaut - Parfait pour l'Australie
• Support mondial - Toutes les villes du monde
• Prvisions 7 jours - Mto dtaille
• Recherche de villes - Trouve les coordonnes facilement
• Interface franaise - Descriptions en franais

Installation rapide

1. Installer les dpendances :

cd weather-mcp-server
npm install

1. Tester immdiatement :

npm start

C'est tout ! Aucune configuration supplmentaire ncessaire.

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

Mto actuelle (Sydney par dfaut)

• city (optionnel) : Nom de la ville (dfaut: Sydney)
• country (optionnel) : Code pays (AU, FR, etc.)

2. get_weather_forecast

Prvisions sur 7 jours (Sydney par dfaut)

• city (optionnel) : Nom de la ville (dfaut: Sydney)
• country (optionnel) : Code pays
• days (optionnel) : Nombre de jours 1-7 (dfaut: 7)

3. get_weather_by_coordinates

Mto par coordonnes GPS (Sydney par dfaut)

• lat (optionnel) : Latitude (dfaut: -33.8688)
• lon (optionnel) : Longitude (dfaut: 151.2093)
• days (optionnel) : Nombre de jours 1-7 (dfaut: 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 :

Mto par dfaut (Sydney) :

• "Quelle est la mto ?"
• "Mto actuelle"
• "Prvisions de la semaine"

Autres villes :

• "Mto Paris"
• "Prvisions pour Londres sur 5 jours"
• "Temprature Tokyo"

Recherche de villes :

• "Trouve les villes appeles Melbourne"
• "Cherche Springfield"

Par coordonnes :

• "Mto aux coordonnes 48.8566, 2.3522"

Avantages d'Open-Meteo

• Totalement gratuit - Pas de limite d'usage raisonnable
• Pas d'inscription - Fonctionne immdiatement
• Donnes prcises - Modles mto professionnels
• API moderne - JSON simple et rapide
• Fiable - Service europen stable

Pourquoi Sydney par dfaut ?

Sydney est configur comme ville par dfaut car :

• Grande mtropole - Reprsentative de l'Australie
• Climat vari - Bon exemple mtorologique
• Fuseau unique - GMT+10/+11 selon saison
• Coordonnes exactes - -33.8688, 151.2093

Dpannage

"Ville non trouve"

• Vrifiez l'orthographe
• Essayez avec le code pays : "Paris, FR"
• Utilisez search_cities pour trouver le bon nom

Erreur de rseau

• Vrifiez votre connexion internet
• Open-Meteo est parfois temporairement indisponible

Le serveur ne dmarre pas

• Vrifiez Node.js : node --version (16 requis)
• Installez les dpendances : npm install

Comparaison avec OpenWeatherMap

Critre	Open-Meteo	OpenWeatherMap
Prix	Gratuit	Gratuit (limit)
Cl API	Aucune	Requise
Inscription	Aucune	Obligatoire
Prvisions	7 jours	5 jours (gratuit)
Prcision
Fiabilit

Dpendances

• @modelcontextprotocol/sdk : SDK officiel MCP
• node-fetch : Client HTTP pour les requtes API

Pas de dpendance externe lourde !

Licence

MIT - Utilisez librement dans vos projets !

---

Fait avec pour Sydney et le monde entier