OpenWeatherMap MCP Server

A Model Context Protocol (MCP) server that provides comprehensive weather data and forecasts through the OpenWeatherMap API. This server enables AI assistants to access real-time weather information, forecasts, air quality data, and location services.

Features

Weather Tools

• Current Weather - Get current conditions for any location
• Weather Forecast - 5-day weather forecast with 3-hour intervals
• Hourly Forecast - Detailed hourly forecasts for up to 48 hours
• Daily Forecast - Daily weather forecasts for up to 8 days with temperature ranges and astronomical data
• Minutely Forecast - Minute-by-minute precipitation forecasts for the next hour
• Weather Alerts - Active weather warnings and alerts with severity classification

Air Quality & Location

• Current Air Pollution - Real-time air quality index and pollutant measurements
• Location Info - Reverse geocoding to get location details from coordinates
• OneCall Weather - Comprehensive weather data combining multiple forecasts
• Air Pollution - Historical and forecast air quality data
• Geocoding - Convert location names to coordinates

Installation

Prerequisites

• Bun runtime
• OpenWeatherMap API key (free at openweathermap.org)

Setup

1. Clone the repository:

git clone https://github.com/robertn702/mcp-openweathermap.git
cd mcp-openweathermap

2. Install dependencies:

bun install

3. Set up your environment variables:

cp .env.example .env
# Edit .env and add your OpenWeatherMap API key

Environment variables:

• OPENWEATHER_API_KEY - Your OpenWeatherMap API key (required for stdio transport only)
• PORT - Server port for HTTP transport (default: 3000)
• MCP_TRANSPORT - Transport type: stdio or httpStream (default: stdio)
• MCP_ENDPOINT - HTTP endpoint path (default: /stream)

Usage

Running the Server

Stdio Transport (default):

bun run src/main.ts

HTTP Stream Transport:

MCP_TRANSPORT=httpStream PORT=3000 bun run src/main.ts

Claude Desktop Configuration

Add this configuration to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "openweathermap": {
      "command": "npx",
      "args": ["mcp-openweathermap"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key-here"
      }
    }
  }
}

API Tools

Weather Information

• get-current-weather - Current weather conditions
• get-weather-forecast - 5-day forecast
• get-hourly-forecast - Hourly forecasts (up to 48 hours)
• get-daily-forecast - Daily forecasts (up to 8 days)
• get-minutely-forecast - Minute-by-minute precipitation