Weather MCP Server

A Model Context Protocol server that provides real-time weather information and forecasts.

This MCP server connects AI assistants with live weather data, enabling them to provide current weather conditions and multi-day forecasts for any location worldwide.

Features

Tools

• fetch-weather - Get current weather conditions for any city

  • Real-time temperature, humidity, wind, and atmospheric data
  • Air quality information included
  • Detailed weather descriptions

• fetch-weather-forecast - Get weather forecasts up to 10 days ahead

  • Daily high/low temperatures
  • Precipitation chances and weather conditions
  • Wind speeds and humidity levels
  • Weather alerts and warnings when available

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
	"mcpServers": {
		"Weather-mcp": {
			"env": {
				"WEATHER_API_KEY": "xxx"
			},
			"command": "node",
			"args": ["/your/path/to/mcp-weather/build/index.js"]
		}
	}
}

You'll need to obtain a free API key from WeatherAPI.com and set it in your environment configuration.

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.