Weather MCP Server

A Model Context Protocol server that provides weather query capabilities using the free Open-Meteo API — no API key required.

Features

• get_weather tool — Query current weather by city name or latitude/longitude coordinates
• weather://current/{lat}/{lon} resource — Access weather data as a resource URI
• Zero-config — Uses Open-Meteo's free API, no API key or account needed

Installation

git clone <repo-url> weather-mcp
cd weather-mcp
npm install
npm run build

Usage

Running the server

npm run dev    # Development mode (tsx, no build step)
npm start      # Production mode (requires npm run build first)

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Code's mcpServers):

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-mcp/dist/index.js"]
    }
  }
}

Or using the dev script:

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["tsx", "/path/to/weather-mcp/src/index.ts"]
    }
  }
}

Available Tool

get_weather

Get current weather conditions for a location.

Parameters (provide either a city name OR coordinates):

Parameter	Type	Description
location	string (optional)	City name, e.g. "Berlin", "Tokyo", "San Francisco"
latitude	number (optional)	Latitude coordinate, e.g. 52.52
longitude	number (optional)	Longitude coordinate, e.g. 13.41

Example responses:

🌤 Weather for Berlin, Germany
─────────────────────────
🌡 Temperature:    22.1°C (feels like 21.5°C)
💧 Humidity:       54%
💨 Wind:           12.3 km/h WSW (248°)
☁ Conditions:     Partly cloudy

Available Resource

weather://current/{lat}/{lon}

Returns current weather as a JSON resource for the given coordinates.

API

This server uses Open-Meteo, a free and open-source weather API. No API key is required. The free tier allows up to 10,000 requests per day.

License

ISC