Weather MCP Server

Weather MCP Server

By szypetike GitHub

A Model Context Protocol server that provides weather information

Overview

what is Weather MCP Server?

Weather MCP Server is a Model Context Protocol (MCP) server that provides real-time weather information for cities around the world.

how to use Weather MCP Server?

To use Weather MCP Server, clone the repository, install the dependencies, and run the server locally. You can also integrate it with MCP-compatible AI assistants by adding the server configuration to your MCP settings.

key features of Weather MCP Server?

  • Get current weather for any city
  • Provides detailed weather information including temperature, humidity, and wind conditions
  • Fallback to mock data if the API request fails

use cases of Weather MCP Server?

  1. Providing real-time weather updates for applications
  2. Integrating with AI assistants for weather inquiries
  3. Developing weather-related features in software applications

FAQ from Weather MCP Server?

  • What programming language is Weather MCP Server built with?

Weather MCP Server is built using JavaScript and requires Node.js.

  • Is there a fallback mechanism if the weather API fails?

Yes! The server can fallback to mock data if the API request fails.

  • How can I get weather information for a specific city?

You can use the get_current_weather tool and provide the city name as input.

Content

Weather MCP Server

smithery badge

A Model Context Protocol (MCP) server that provides weather information for cities around the world.

Features

  • Get current weather for any city
  • Provides temperature, weather conditions, humidity, wind information, and more
  • Fallback to mock data if API request fails

Requirements

  • Node.js (v14 or higher)
  • npm or yarn
  • OpenWeather API key (optional - will use mock data if not provided)

Installation

  1. Clone this repository
  2. Install dependencies: 
    npm install
  3. Build the server: 
    npm run build

Usage

Running locally

npm start

Using with Claude or other MCP-compatible AI assistants

Add the following configuration to your MCP settings:

{
  "mcpServers": {
    "weather-server": {
      "command": "node",
      "args": ["path/to/weather-server/build/index.js"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key-here" // Optional - will use mock data if not provided
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

API Key and Mock Data

This server can operate in two modes:

  1. With API Key: When an OpenWeather API key is provided via the OPENWEATHER_API_KEY environment variable, the server will fetch real-time weather data from the OpenWeather API.

  2. Without API Key: If no API key is provided, the server will automatically use mock data for a set of predefined cities (London, New York, Tokyo, Paris, Sydney). For other cities, it will use default mock data.

To get an OpenWeather API key:

  1. Sign up at OpenWeather
  2. Navigate to your account's "API keys" section
  3. Generate a new API key or use an existing one

The mock data mode is useful for development, testing, or when you don't need real-time weather data.

Available Tools

get_current_weather

Get current weather information for a specified city.

Input Schema:

{
  "city": "string" // City name (e.g., "London", "New York", "Tokyo")
}

Example Response:

{
  "location": "London, GB",
  "date": "Monday, March 24, 2025",
  "time": "7:30:00 PM",
  "temperature": {
    "current": "12°C",
    "feelsLike": "10°C"
  },
  "weather": {
    "main": "Cloudy",
    "description": "Overcast clouds",
    "icon": "https://openweathermap.org/img/wn/04d@2x.png"
  },
  "details": {
    "humidity": "75%",
    "pressure": "1012 hPa",
    "windSpeed": "4.5 m/s",
    "windDirection": "230°",
    "cloudiness": "90%",
    "sunrise": "6:45 AM",
    "sunset": "7:30 PM"
  },
  "source": "OpenWeather API" // or "Mock Data (No API key provided)" or "Mock Data (API request failed)"
}

The source field in the response indicates where the data came from:

  • "OpenWeather API": Real-time data from the OpenWeather API
  • "Mock Data (No API key provided)": Mock data used because no API key was provided
  • "Mock Data (API request failed)": Mock data used because the API request failed

License

MIT

No tools information available.
No content found.